Admin: 1 revision imported

2021-02-07T06:51:28Z

1 revision imported

Admin at 07:23, 24 April 2020

2020-04-24T07:23:53Z

New page

{{infobox function
|name=Receive
|object=[[Объект IP]]
|caption=Обмен данными
|type=1
|status=2
|db=0
|exception=Разрыв соединения, системная ошибка
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект IP]]}}
TCP/IP функция получает данные в ANSI-строку по установленному соединению. Данные могут представлять собой бинарную информацию. Функцию можно использовать только для не блокирующих, не шифрованных соединений. Функция получает столько информации, сколько в данный момент ожидает в буфере операционной системы, и, после этого сразу возвращает управление. Никакого внутреннего ожидания не выполняется. Функция работает быстрее других функций получения, однако, требует создания дополнительного цикла ожидания готовности данных с помощью функции [[IPConnection.Wait|Wait]]. Функция может вернуть пустую строку, если в данный момент в буфере системы нет никакой информации. Если произошел разрыв связи, функция вызывает исключение.

== Синтаксис ==
<code>
{{Grey|IPConnection.}}'''Receive'''({{Optional|<Максимальный размер данных в байтах (INT)>}}):''<Полученная строка (STRING)>''
</code>

==== Аргументы ====
* <code>''<Максимальный размер данных в байтах (INT)>''</code> - {{Optional}} Аргумент задает максимальный размер получаемых данных.

==== Возвращаемое значение ====
Возвращается полученные данные из буфера системы, в виде строки ANSI.

== Примеры ==
<pre>
//Пример функции получения информации в виде буфера при неблокирующем соединении
//Обычно, к примеру, для прокси соединений, для полного дуплекса, чтение осуществляется одновременно с записью, поэтому, для прокси соединения эту функцию было бы необходимо изменить
Function ПринятьБуфер(Размер,Сокет)
Буфер:=Buffer.Create();
iPos:=0;
While iPos<Размер Do
Size2:=Min(Размер-iPos,2048);
Стр:=Сокет.Receive(Size2);
If Length(Стр)>0 Then
Буфер.SetString(iPos,Стр);
iPos:=iPos+Length(Стр);
Continue;
EndIf;
Сокет.Wait(50,1);
EndDo;
Exit Буфер;
EndFunction
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

IPConnection.Receive - Revision history

Admin: 1 revision imported

Admin at 07:23, 24 April 2020