Main Content

configureCallback

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

自 R2020b 起

说明

示例

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

使用 configureTerminator 设置终止符字符。

示例

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

示例

configureCallback(t,"off") 关闭回调。该语法将 tBytesAvailableFcnMode 属性设置为 "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 中推出

另请参阅

函数