Main Content

writeline

Write line of ASCII data to remote host over TCP/IP

Description

example

writeline(t,data)写ASCIItextdatafollowed by the terminator to the remote host specified by the TCP/IP clientt. The function suspends MATLAB®execution until the data and terminator are written.

Examples

collapse all

Create a TCP/IP client connection calledt, connecting to a TCP/IP echo server with port 4000. To do so, you must have anechotcpipserver 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

Check the default ASCII terminator.

t.Terminator
ans = "LF"

Set the terminator to"CR"and write a string of ASCII data. Thewritelinefunction automatically appends the terminator to the data.

configureTerminator(t,"CR") writeline(t,"hello")

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

writeline(t,"world")

Since the client is connected to an echo server, the data you write to the server is returned to the client. Read a string of ASCII data. Thereadlinefunction returns data until it reaches a terminator.

readline(t)
ans = "hello"

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

readline(t)
ans = "world"

Close the echo server and clear the TCP/IP client connection.

echotcpip("off") cleart

Input Arguments

collapse all

TCP/IP client, specified as atcpclientobject.

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

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

Example:writeline(t,"helloworld")写ASCIIdata"helloworld".

Data Types:char|string

Version History

Introduced in R2020b