本页面提供的是上一版软件的文档。当前版本中已删除对应的英文页面。

tcpclient

创建 TCP/IP 客户端对象以通过 TCP/IP 进行通信

说明

示例

t = tcpclient('Address',Port) 构造一个与远程主机 Address 和远程端口值 Port 相关联的 TCP/IP 对象 t。地址可以为远程主机名称或远程 IP 地址。端口必须为介于 165535 之间的正整数。

如果指定的地址或端口无效,或者无法建立与服务器的连接,则不会创建该对象。

示例

t = tcpclient('Address',Port,'Timeout',<timeout_value>) 会额外设置一个超时值。Timeout 属性以秒为单位指定完成读写操作的等待时间,默认为 10

示例

t = tcpclient('Address',Port,'ConnectTimeout',<connect_timeout_value>) 会额外设置一个连接超时值。ConnectTimeout 属性指定等待对指定远程主机的连接请求是成功还是失败的最长时间(以秒为单位)。默认值为 Inf

示例

全部折叠

使用所示的主机地址和端口 80 创建 TCP/IP 对象 t

t = tcpclient('www.mathworks.com', 80)
t = 

   tcpclient with properties:

          Address: 'www.mathworks.com'
             Port: 80
          Timeout: 10
   BytesAvailable: 0
   ConnectTimeout: Inf

注意

使用主机名(如指定的 Web 地址或 'localhost')连接时,IP 地址默认为 IPv6 格式。如果您要连接的服务器需要 IPv4 格式,连接将失败。如果出现这种情况,您可以通过指定显式 IP 地址而不是主机名来进行连接。

使用所示的 IP 地址和端口 4012 创建 TCP/IP 对象 t

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

   tcpclient with properties:

          Address: '172.28.154.231'
             Port: 4012
          Timeout: 10
   BytesAvailable: 0
   ConnectTimeout: Inf

创建 TCP/IP 对象 t,并将 Timeout 增加到 20 秒。

t = tcpclient('172.28.154.231', 4012, 'Timeout', 20)
t = 

   tcpclient with properties:

          Address: '172.28.154.231'
             Port: 4012
          Timeout: 20
   BytesAvailable: 0
   ConnectTimeout: Inf

输出会反映 Timeout 属性更改。

创建 TCP/IP 对象 t,并将 ConnectTimeout 设置为 30 秒。

t = tcpclient('172.28.154.231', 4012, 'ConnectTimeout', 30)
t = 

   tcpclient with properties:

          Address: '172.28.154.231'
             Port: 4012
          Timeout: 10
   BytesAvailable: 0
   ConnectTimeout: 30

输出会反映 ConnectTimeout 属性更改。

输入参数

全部折叠

要连接的远程主机名称或 IP 地址,指定为字符向量。在创建 tcpclient 对象时将地址指定为第一个参数。

示例: t = tcpclient('www.mathworks.com', 4012)

数据类型: char

要连接的远程主机端口,指定为数值标量。在创建 tcpclient 对象时将端口号指定为第二个参数。Port 必须为介于 165535 之间的正整数。

示例: t = tcpclient('www.mathworks.com', 4012)

数据类型: double

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: t = tcpclient('172.28.154.231', 120, 'Timeout', 15, 'ConnectTimeout', 30)

读/写操作的超时,指定为以逗号分隔的对组,包含 'Timeout' 和一个 double 类型的正值。您可以在创建对象期间或在创建对象之后更改该值。

有关如何在创建对象之后更改超时值的信息,请参阅“配置 TCP/IP 通信的属性”。

示例: t = tcpclient('172.28.154.231', 4012, 'Timeout', 20)

数据类型: double

远程主机连接超时值,指定为以逗号分隔的对组,包含 'ConnectTimeout' 和一个 double 类型的正值。该属性指定等待对指定远程主机的连接请求是成功还是失败的最长时间(以秒为单位)。您只能在对象创建过程中更改该值。

示例: t = tcpclient('172.28.154.231', 4012, 'ConnectTimeout', 30)

数据类型: double

扩展功能

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

在 R2014b 中推出