IPConnection.ReceiveStrRaw

From SunFlurry wiki
Jump to: navigation, search
  ReceiveStrRaw (Обмен данными)
Объект:Объект IP
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в число, разрыв соединения, системная ошибка
Визуальность:Нет

TCP/IP функция получает строку указанной длины по установленному соединению. Строка может быть как в ANSI-кодировке, так и в Unicode. Таким образом можно получать также бинарную информацию в виде ANSI-строки для дальнейшей ее обработки. Функцию можно использовать как для блокирующих, так и для не блокирующих соединений. Если соединение будет разорвано до успешного получения данных, функция вызовет исключение.

Синтаксис

IPConnection.ReceiveStrRaw(<Длина получаемой строки (INT)>,<Получаемая строка имеет формат UTF-16 (INT)>=0):<Полученная строка (STRING)>

Аргументы

  • <Длина получаемой строки (INT)> - Аргумент задает длину строки в символах (в случае UTF-16, длина строки в два раза меньше занимаемого ей места в байтах).
  • <Отослать строку в UTF-16 (INT)> - (необязательный аргумент) По умолчанию (0), строка принимается в ANSI кодировке (и может содержать бинарные данные), если этот параметр равен 1, строка будет принята в UTF-16 (один символ задается двумя или четырьмя байтами, см. Строки).

Возвращаемое значение

Возвращается принятая строка.

Примеры

Сокет:=IPConnection.Connect("127.0.0.1:5555");
If not Сокет.IsConnected() Then
  Message("Сервер не отвечает","!");
  Exit 0;
EndIf;
Try
  Чл:=Сокет.ReceiveNumber(2);  
  Стр:=Сокет.ReceiveStrRaw(Чл);
  StringToFile(Стр,"c:\Test.bin");
  Exit 1;
Except
  Exit 0;
EndTry;