Main Content

write

Write data from TCP/IP server

    Description

    example

    write(t,data) writes the row or column vector data 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.

    example

    write(t,data,datatype) writes data in the form specified by datatype, regardless of the format in data.

    Examples

    collapse all

    Create a TCP/IP server that listens for a client connection request at the specified port and IP address. Then, write data from the server to the connected client.

    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
    
    

    Display the values of the Connected, ClientAddress, and ClientPort properties for server.

    server
    server = 
      TCPServer with properties:
    
            ServerAddress: "127.0.0.1"
               ServerPort: 4000
                Connected: 1
            ClientAddress: "127.0.0.1"
               ClientPort: 49653
        NumBytesAvailable: 0
    
      Show all properties, functions
    
    

    The output shows that server successfully accepts a request from client and that client establishes a connection to server.

    Send data to the client by writing it using the server object. Since the client is connected to the server, this data is available in the client. Read the data from the client object.

    write(server,[6,9,14,26,27,42],"uint8")
    read(client,client.NumBytesAvailable)
    ans = 1×6 uint8 row vector
    
        6    9   14   26   27   42
    
    

    Create a TCP/IP server that listens for a client connection request at the specified port and IP address. Then, write data from the server to the connected client.

    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
    
    

    See the values of the Connected, ClientAddress, and ClientPort properties for server.

    server
    server = 
      TCPServer with properties:
    
            ServerAddress: "127.0.0.1"
               ServerPort: 4000
                Connected: 1
            ClientAddress: "127.0.0.1"
               ClientPort: 65136
        NumBytesAvailable: 0
    
      Show all properties, functions
    
    

    The output shows that server successfully accepts a request from client and that client establishes a connection to server.

    Send data to the client by writing it using the server object. Since the client is connected to the server, this data is available in the client. Read this data from the client object.

    write(server,"hello world","string")
    read(client,11,"string")
    ans = 
    "hello world"
    

    Input Arguments

    collapse all

    TCP/IP server, specified as a tcpserver object.

    Example: write(t,10) writes from the TCP/IP server t to the client connected to it.

    Numeric or ASCII data, specified as a row (1-by-N) or column (N-by-1) 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: write(t,300) writes the value 300.

    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.

    For any read or write operation, the data type is converted to uint8 for the data transfer. After the transfer, the data type reverts to the specified datatype.

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

    Data Types: char | string

    Introduced in R2021a