Main Content

writebinblock

Write one binblock of data to remote host over TCP/IP

    Description

    example

    writebinblock(t,data,datatype) writes a binblock of data in the form specified by datatype to the remote host specified by the TCP/IP client t. The function suspends MATLAB® execution until the specified values are written to the remote host.

    Examples

    collapse all

    Create a TCP/IP client connection called t, connecting to a TCP/IP echo server with port 4000. To do so, you must have an echotcpip server running on port 4000.

    echotcpip("on",4000)
    t = tcpclient("localhost",4000)
    t = 
      tcpclient with properties:
    
                  Address: 'localhost'
                     Port: 4000
        NumBytesAvailable: 0
    
      Show all properties, functions
    
    

    Write the values [1,2,3,4,5] as a binblock in uint8 format.

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

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

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

    Since the client is connected to an echo server, the data you write to the server is returned to the client. Read the first binblock of data that you wrote.

    readbinblock(t)
    ans = 1×5
    
         1     2     3     4     5
    
    

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

    readbinblock(t,"double")
    ans = 1×5
    
         6     7     8     9    10
    
    

    Close the connection between the TCP/IP client and the remote host by clearing the object. Turn off the echotcpip server.

    clear t
    echotcpip("off")

    Input Arguments

    collapse all

    TCP/IP client, specified as a tcpclient object.

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

    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

    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

    Introduced in R2020b