Exponenta Banner

tcpclient

Создайте объект клиента TCP/IP, чтобы связаться по TCP/IP

свернуть все на странице

Синтаксис

t = tcpclient('Address',Port)
t = tcpclient('Address',Port,'Timeout',<timeout_value>)
t = tcpclient('Address',Port,'ConnectTimeout',<connect_timeout_value>)

Описание

пример

t = tcpclient('Address',Port) создает объект TCP/IP, t, сопоставленный с удаленным хостом, Address, и значением удаленного порта, Port. Адрес может быть или удаленным именем хоста или удаленным IP-адресом. Порт должен быть положительным целым числом между 1 и 65535.

Если недопустимый адрес или порт будут заданы, или связь с сервером не может быть установлена, объект не будет создан.

пример

t = tcpclient('Address',Port,'Timeout',<timeout_value>) дополнительно устанавливает значение тайм-аута. Свойство Timeout задает время ожидания, чтобы завершить операции чтения и операции записи в секундах, и значением по умолчанию является 10.

пример

t = tcpclient('Address',Port,'ConnectTimeout',<connect_timeout_value>) дополнительно устанавливает значение тайм-аута связи. Свойство ConnectTimeout указывает, что максимальное время в секундах, чтобы ожидать связи запрашивает к заданному удаленному хосту успешно выполниться или перестать работать. Значением по умолчанию является Inf.

Примеры

свернуть все

Создайте объект TCP/IP, к которому t с помощью хоста обращается показанный и Порт 80.

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

   tcpclient with properties:

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

Примечание

При соединении использования имени хоста, такого как заданный веб-адрес или 'localhost', IP-адрес примет значение по умолчанию к формату IPv6. Если сервер, с которым вы соединяетесь, будет ожидать формат IPv4, он перестанет работать. Если это происходит, можно соединиться путем определения явного IP-адреса, а не имени хоста.

Создайте объект TCP/IP t с помощью показанного IP-адреса и Порт 4012.

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 должен быть положительным целым числом между 1 и 65535.

Пример: t = tcpclient('www.mathworks.com', 4012)

Типы данных: double

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: t = tcpclient('172.28.154.231', 120, 'Timeout', 15, 'ConnectTimeout', 30)

Тайм-аут для операции чтения-записи, заданной как пара, разделенная запятой, состоящая из 'Timeout' и положительное значение типа double. Можно изменить значение или во время создания объекта или после того, как вы создадите объект.

Для получения информации о том, как изменить значение тайм-аута после создания объекта, смотрите Configure Properties для Коммуникации TCP/IP.

Пример: t = tcpclient('172.28.154.231', 4012, 'Timeout', 20)

Типы данных: double

Тайм-аут для связи с удаленным хостом, заданным как пара, разделенная запятой, состоящая из 'ConnectTimeout' и положительное значение типа double. Свойство указывает, что максимальное время в секундах, чтобы ожидать связи запрашивает к заданному удаленному хосту успешно выполниться или перестать работать. Можно только изменить значение во время создания объекта.

Пример: t = tcpclient('172.28.154.231', 4012, 'ConnectTimeout', 30)

Типы данных: double

Смотрите также

Темы

Введенный в R2014b

Документация MATLAB
Поддержка