Main Content

configureTerminator

为通过 TCP/IP 与远程主机进行的 ASCII 字符串通信设置终止符

自 R2020b 起

全页折叠

语法

configureTerminator(t,terminator)
configureTerminator(t,readterminator,writeterminator)

说明

configureTerminator(t,terminator) 定义与由 TCP/IP 客户端 t 指定的远程主机进行读写通信的终止符。允许的终止符值是 "LF"（默认值）、"CR"、"CR/LF" 以及 0 到 255 的整数值。该语法设置 t 的 Terminator 属性。

设置终止符后，使用 writeline 和 readline 写入和读取以 ASCII 字符结尾的字符串数据。

示例

configureTerminator(t,readterminator,writeterminator) 为读取和写入通信定义单独的终止符。

示例

示例

全部折叠

使用 IP 地址 172.28.154.231 和端口 4012 创建一个名为 t 的 TCP/IP 客户端。

t = tcpclient("172.28.154.231",4012)
t = 

  tcpclient with properties:

              Address: '172.28.154.231'
                 Port: 4012
    NumBytesAvailable: 0

  Show all properties, functions

将读取终止符和写入终止符都设置为 "CR/LF"。

configureTerminator(t,"CR/LF")

确认更改。

t.Terminator
ans = 
"CR/LF"

使用 IP 地址 172.28.154.231 和端口 4012 创建一个名为 t 的 TCP/IP 客户端。

t = tcpclient("172.28.154.231",4012)
t = 

  tcpclient with properties:

              Address: '172.28.154.231'
                 Port: 4012
    NumBytesAvailable: 0

  Show all properties, functions

将读取终止符设置为 "CR"，将写入终止符设置为 10。

configureTerminator(t,"CR",10)

确认更改。

t.Terminator
ans=1×2 cell array
    {["CR"]}    {[10]}

数组中的第一个元素是读取终止符，第二个元素是写入终止符。

打开实时脚本

创建一个名为 t 的 TCP/IP 客户端连接，使用端口 4000 连接到 TCP/IP 回显服务器。为此，您必须有在端口 4000 上运行的 echotcpip 服务器。

echotcpip("on",4000)
t = tcpclient("localhost",4000)
t = 
  tcpclient with properties:

              Address: 'localhost'
                 Port: 4000
    NumBytesAvailable: 0

  Show all properties, functions

检查默认的 ASCII 终止符。

t.Terminator
ans = 
"LF"

将终止符设置为 "CR"，并写入一个 ASCII 数据字符串。writeline 函数自动将终止符追加到数据中。

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

写入自动追加了终止符的另一个 ASCII 数据字符串。

writeline(t,"world")

由于客户端连接到回显服务器，您写入服务器的数据将返回到客户端。读取一个 ASCII 数据字符串。readline 函数返回数据，直到到达终止符。

readline(t)
ans = 
"hello"

再次读取一个 ASCII 数据字符串，以返回您写入的第二个字符串。

readline(t)
ans = 
"world"

关闭回显服务器并清除 TCP/IP 客户端连接。

echotcpip("off")
clear t

输入参数

全部折叠

TCP/IP 客户端，指定为 tcpclient 对象。

示例: configureTerminator(t,"CR/LF") 设置 TCP/IP 客户端 t 的终止符值。

读取和写入通信的 ASCII 终止符，指定为 "LF"、"CR"、"CR/LF" 或 0 到 255 之间的一个整数数值。当为读取和写入设置相同的终止符时，请使用此形式。当从终止符值为 "CR/LF" 的远程主机中读取时，读取会在同时出现 CR 和 LF 时终止。当写入终止符值为 "CR/LF" 的远程主机时，写入通过同时添加 CR 和 LF 这两者来终止。此输入参量设置 Terminator 属性。

示例: configureTerminator(t,"CR/LF") 将读取终止符和写入终止符都设置为 "CR/LF"。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | string

读取或写入通信的 ASCII 终止符，指定为 "LF"、"CR"、"CR/LF" 或 0 到 255 之间的一个整数数值。当为读取和写入设置不同的终止符时，请使用此形式。当从终止符值为 "CR/LF" 的远程主机中读取时，读取会在同时出现 CR 和 LF 时终止。当写入终止符值为 "CR/LF" 的远程主机时，写入通过同时添加 CR 和 LF 这两者来终止。此输入参量设置 Terminator 属性。

示例: configureTerminator(t,"CR",10) 将读取终止符设置为 "CR"，将写入终止符设置为 10。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | string

版本历史记录

在 R2020b 中推出

另请参阅

函数