Main Content

readline

从串行端口读取 ASCII 字符串数据行

自 R2019b 起

全页折叠

语法

data = readline(device)

说明

示例

data = readline(device) 从串行端口连接读取 ASCII 数据，直到第一次出现终止符，并以不带终止符的字符串形式返回 data。如果该函数无法在 device 的 Timeout 属性指定的时间段内返回任何数据，它将以 0×0 双精度 [] 形式返回 data。该函数暂停 MATLAB® 的执行，直到到达终止符或发生超时。

示例

全部折叠

创建到串行端口设备的连接。在此示例中，COM3 上的串行端口连接到环回设备。

device = serialport("COM3",9600)
device = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
    NumBytesAvailable: 0

  Show all properties, functions

检查默认的 ASCII 终止符。

device.Terminator
ans = 

    "LF"

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

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

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

writeline(device,"world")

由于该端口连接到环回设备，您写入该设备的数据将返回到 MATLAB。读取一个 ASCII 数据字符串。readline 函数返回数据，直到到达终止符。

readline(device)
ans = 

    "hello"

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

readline(device)
ans = 

    "world"

清除串行端口连接。

clear device

输入参数

全部折叠

串行端口连接，指定为 serialport 对象。

示例: readline(device) 从串行端口连接 device 读取 ASCII 数据。

版本历史记录

在 R2019b 中推出

另请参阅

函数