Main Content

writeline

Write line of ASCII data from TCP/IP server

    Description

    example

    writeline(t,data) writes the ASCII text data followed by the terminator 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 data and terminator are written.

    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
    
    

    Check the default ASCII terminator for the server.

    server.Terminator
    ans = 
    "LF"
    

    Set the terminators for both the server and client to "CR". The TCP/IP server and its connected client must have the same terminator.

    configureTerminator(server,"CR")
    configureTerminator(client,"CR")

    Write a string of ASCII data from the server to the client by writing it to the server object. The writeline function automatically appends the terminator to the data.

    writeline(server,"hello")

    Write another string of ASCII data with the terminator automatically appended.

    writeline(server,"world")

    Since the client is connected to the server, the data you write is available in the client. Read a string of ASCII data from the client object. The readline function returns data until it reaches a terminator.

    readline(client)
    ans = 
    "hello"
    

    Read a string of ASCII data again to return the second string.

    readline(client)
    ans = 
    "world"
    

    Input Arguments

    collapse all

    TCP/IP server, specified as a tcpserver object.

    Example: writeline(t,data) writes ASCII data to the TCP/IP client connected to the server t.

    ASCII data to write, specified as a character vector or string scalar of text.

    Example: writeline(t,"helloworld") writes the ASCII data "helloworld".

    Data Types: char | string

    Introduced in R2021a