2024-12-16 15:44:01 +03:00
---
sidebar_position: 3
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
2024-12-16 16:30:49 +03:00
# Прочитать двоичные данные
Читает данные из указанного соединения
2024-12-16 15:44:01 +03:00
`Функция ПрочитатьДвоичныеДанные(Знач Соединение, Знач МаксимальныйРазмер = 0, Знач Маркер = "", Знач Таймаут = 5000) Экспорт`
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|-|-|-|-|-|
2024-12-16 20:23:39 +03:00
| Соединение | - | Произвольный | ✔ | Соединение, см. ОткрытьСоединение |
| МаксимальныйРазмер | - | Число | ✖ | Максимальный размер данных (байт). 0 > без ограничений |
| Маркер | - | Строка, ДвоичныеДанные | ✖ | Маркер конца сообщения. Пусто > без маркера |
| Таймаут | - | Число | ✖ | Таймаут ожидания данных (мс). 0 > без ограничений |
2024-12-16 15:44:01 +03:00
Возвращаемое значение: ДвоичныеДанные - Полученные данные
<br/>
:::tip
При работе с бесконечным потоком входящих данных обязательно указание параметра МаксимальныйРазмер, так как бесконечное получение данных может привести к зависанию
При закрытии соединения, ошибке или обнаружении EOF чтение завершается в любом случае
Параметры с типом данных Двоичные данные могут принимать также пути к файлам на диске и URL
:::
2024-12-16 19:16:01 +03:00
:::caution
2024-12-16 19:38:57 +03:00
**NOCLI:** данный метод недоступен для использования в CLI версии
2024-12-16 19:16:01 +03:00
:::
<br/>
2024-12-16 15:44:01 +03:00
2024-12-16 19:38:57 +03:00
2024-12-16 15:44:01 +03:00
```bsl title="Пример использования для 1С:Предприятие/OneScript"
Адрес = "45.79.112.203:4242";
Соединение = OPI_TCP.ОткрытьСоединение(Адрес);
Сообщение = "Hello server!" + Символы.ПС;
Данные = ПолучитьДвоичныеДанныеИзСтроки(Сообщение);
OPI_TCP.ОтправитьДвоичныеДанные(Соединение, Данные);
// Маркер конца сообщения для исключения ожидания конца таймаута
Маркер = Символы.ПС;
Результат = OPI_TCP.ПрочитатьДвоичныеДанные(Соединение, , Маркер);
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
OPI_TCP.ЗакрытьСоединение(Соединение);
```
2024-12-16 19:16:01 +03:00
2024-12-16 15:44:01 +03:00
```json title="Результат"
"Hello server!\n"
```