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 имя аргумента и 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

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

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

Темы

Введенный в R2014b

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