Main Content

writebinblock

Write one binblock of data from TCP/IP server

Since R2021a

    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.

    example

    Examples

    collapse all

    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

    collapse all

    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.

    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

    Version History

    Introduced in R2021a