Main Content

configureCallback

为通过 TCP/IP 与远程主机的通信设置回调函数和触发条件

自 R2020b 起

全页折叠

语法

configureCallback(t,"terminator",callbackFcn)
configureCallback(t,"byte",count,callbackFcn)
configureCallback(t,"off")

说明

configureCallback(t,"terminator",callbackFcn) 将回调函数 callbackFcn 设置为每当可从 TCP/IP 客户端 t 指定的远程主机读取终止符时触发。该语法将 t 的 BytesAvailableFcnMode 属性设置为 "terminator"，将 BytesAvailableFcn 属性设置为 callbackFcn。

使用 configureTerminator 设置终止符字符。

示例

configureCallback(t,"byte",count,callbackFcn) 将回调函数 callbackFcn 设置为每当有新的 count 个字节可供读取时触发。该语法将 t 的 BytesAvailableFcnMode 属性设置为 "byte"，将 BytesAvailableFcnCount 属性设置为 count，将 BytesAvailableFcn 属性设置为 callbackFcn。

示例

configureCallback(t,"off") 关闭回调。该语法将 t 的 BytesAvailableFcnMode 属性设置为 "off"。

示例

示例

全部折叠

使用 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

将回调设置为当终止符可供读取时触发。

configureCallback(t,"terminator",@callbackFcn)

查看属性以确认更改。

t.BytesAvailableFcnMode
t.BytesAvailableFcn
ans = 

    "terminator"


ans =

  function_handle with value:

    @callbackFcn

关闭回调。

configureCallback(t,"off")

验证回调已关闭。

t.BytesAvailableFcnMode
ans = 

    "off"

使用 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

将回调设置为当有 50 个字节的数据可供读取时触发。

configureCallback(t,"byte",50,@callbackFcn)

查看属性以确认更改。

t.BytesAvailableFcnMode
t.BytesAvailableFcnCount
t.BytesAvailableFcn
ans = 

    "byte"


ans =

    50


ans =

  function_handle with value:

    @callbackFcn

关闭回调。

configureCallback(t,"off")

验证回调已关闭。

t.BytesAvailableFcnMode
ans = 

    "off"

输入参数

全部折叠

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

示例: configureCallback(t,"byte",128,@callbackFcn) 将 callbackFcn 回调设置为每当有 128 个字节的新数据可从 TCP/IP 客户端 t 读取时触发。

触发回调的可用数据字节数，指定为正整数值。使用此参量设置 BytesAvailableFcnCount 属性。

示例: configureCallback(t,"byte",128,@callbackFcn) 将 callbackFcn 回调设置为每当有 128 个字节的新数据可供读取时触发。

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

满足触发条件时运行的回调函数，指定为函数句柄。函数句柄可以是命名函数句柄，也可以是带输入参量的匿名函数。使用此参量设置 BytesAvailableFcn 属性。

示例: configureCallback(t,"terminator",@callbackFcn) 将 callbackFcn 回调设置为当终止符可供读取时触发。

数据类型: function_handle

版本历史记录

在 R2020b 中推出

另请参阅

函数