writebinblock

Write one binblock of data from TCP/IP server

Since R2021a

Syntax

writebinblock(t,data,datatype)

Description

writebinblock(t,data,datatype) writes a binblock of data in the form specified by datatype from the TCP/IP server t to the client connected to it. The value of the Connected property of t must be 1 (true) before you can write from it. The function suspends MATLAB^® execution until the specified values are written to the remote host.

Examples

Write Binblock of Data from TCP/IP Server

Create a TCP/IP server that listens for connections at localhost and port 4000.

server = tcpserver("localhost",4000)

server = 
  TCPServer with properties:

        ServerAddress: "127.0.0.1"
           ServerPort: 4000
            Connected: 0
        ClientAddress: ""
           ClientPort: []
    NumBytesAvailable: 0

  Show all properties, functions

Create a TCP/IP client to connect to your server object using tcpclient. You must specify the same IP address and port number you use to create server.

client = tcpclient("localhost",4000)

client = 
  tcpclient with properties:

              Address: 'localhost'
                 Port: 4000
    NumBytesAvailable: 0

  Show all properties, functions

Write the values [1,2,3,4,5] from the server to the client by writing it to the server object as a binblock in uint8 format.

writebinblock(server,1:5,"uint8")

Write another binblock of data. Write the values [6,7,8,9,10] as double data.

writebinblock(server,6:10,"double")

Since the client is connected to the server, the data you write to the server is available to be read from the client object. Read the first binblock of data.

readbinblock(client)

ans = 1×5

     1     2     3     4     5

Read a binblock of data again to return the second set of values. Specify the data as double.

readbinblock(client,"double")

ans = 1×5

     6     7     8     9    10

Input Arguments

t — TCP/IP server

tcpserver object

TCP/IP server, specified as a tcpserver object.

Example: writebinblock(t,1:5,"uint8") writes a binblock of data to the TCP/IP client connected to the server t.

data — Numeric or ASCII data

1-by-N numeric array | character vector | string scalar

Numeric or ASCII data, specified as a 1-by-N vector of numeric values or as a character vector or string scalar of text. For all numeric datatype types, data is a row vector of values.

Example: writebinblock(t,1:5,"uint8") writes the values [1,2,3,4,5].

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | string

datatype — Size and format of each value

"uint8" | "int8" | "uint16" | "int16" | "uint32" | "int32" | "uint64" | "int64" | "single" | "double" | "char" | "string"

Size and format of each value, specified as a character vector or string. datatype determines the number of bytes to write for each value and the interpretation of those bytes as a MATLAB data type.

Example: writebinblock(t,1:5,"double") writes the values [1,2,3,4,5] as double data.

Data Types: char | string

Version History

Introduced in R2021a