configureTerminator
Description
configureTerminator(
defines the terminator for both read and write communications with the client connected to
the TCP/IP server t
,terminator
)t
. Allowed terminator values are
"LF"
(default), "CR"
, "CR/LF"
,
and integer values from 0 to 255. The syntax sets the Terminator
property of t
.
After you set the terminator, use writeline
and
readline
to write and read ASCII-terminated string data.
configureTerminator(
defines separate terminators for read and write communications.t
,readterminator,writeterminator
)
Examples
Set Same Terminator for Read and Write Communication
Create a TCP/IP server on port 4000.
server = tcpserver(4000)
server = TCPServer with properties: ServerAddress: "::" ServerPort: 4000 Connected: 0 ClientAddress: "" ClientPort: [] NumBytesAvailable: 0 Show all properties, functions
Set both the read and write terminators to "CR/LF"
.
configureTerminator(server,"CR/LF")
If you have a client connected to the server, you must set the same terminators for the client and server to successfully perform readline
and writeline
operations.
Confirm the change.
server.Terminator
ans = "CR/LF"
Set Different Terminators for Read and Write Communication
Create a TCP/IP server on port 4000.
server = tcpserver(4000)
server = TCPServer with properties: ServerAddress: "::" ServerPort: 4000 Connected: 0 ClientAddress: "" ClientPort: [] NumBytesAvailable: 0 Show all properties, functions
Set the read terminator to "CR"
and the write terminator to 10
.
configureTerminator(server,"CR",10)
If you have a client connected to the server, you must set the same terminators for the client and server to successfully perform readline
and writeline
operations.
Confirm the change.
server.Terminator
ans=1×2 cell array
{["CR"]} {[10]}
Write Line of ASCII Data from TCP/IP Server
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
t
— TCP/IP server
tcpserver
object
TCP/IP server, specified as a tcpserver
object.
Example: configureTerminator(t,"CR/LF")
sets the terminator value
for the TCP/IP server t
.
terminator
— ASCII terminator
"LF"
(default) | "CR"
| "CR/LF"
| 0 to 255
ASCII terminator for read and write communication, specified as
"LF"
, "CR"
, "CR/LF"
, or a
numeric integer value from 0 to 255. Use this form when setting the same terminator for
both read and write. When reading from the remote host with a terminator value of
"CR/LF"
, the read terminates on an occurrence of
CR
and LF
together. When writing to the remote
host with a terminator value of "CR/LF"
, the write terminates by
adding both CR
and LF
. This input argument sets
the Terminator
property.
Example: configureTerminator(t,"CR/LF")
sets both the read and
write terminators to "CR/LF"
.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| char
| string
readterminator,writeterminator
— ASCII terminators for read and write
"LF"
(default) | "CR"
| "CR/LF"
| 0 to 255
ASCII terminators for read or write communication, specified as
"LF"
, "CR"
, "CR/LF"
, or a
numeric integer value from 0 to 255. Use this form when setting different terminators
for read and write. When reading from the remote host with a terminator value of
"CR/LF"
, the read terminates on an occurrence of
CR
and LF
together. When writing to the remote
host with a terminator value of "CR/LF"
, the write terminates by
adding both CR
and LF
. This input argument sets
the Terminator
property.
Example: configureTerminator(t,"CR",10)
sets the read terminator
to "CR"
and write terminator to 10
.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| char
| string
Version History
Introduced in R2021a
See Also
Comando MATLAB
Hai fatto clic su un collegamento che corrisponde a questo comando MATLAB:
Esegui il comando inserendolo nella finestra di comando MATLAB. I browser web non supportano i comandi MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)