1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2025-03-23 21:29:38 +02:00
OpenIntegrations/docs/en/md/TCP/Tcp-client/Read-binary-data.mdx

62 lines
1.8 KiB
Plaintext
Raw Normal View History

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
# Read binary data
Reads data from the specified connection
2024-12-16 15:44:01 +03:00
`Function ReadBinaryData(Val Connection, Val MaxSize = 0, Val Marker = "", Val Timeout = 5000) Export`
| Parameter | CLI option | Type | Required | Description |
|-|-|-|-|-|
2024-12-16 20:23:39 +03:00
| Connection | - | Arbitrary | ✔ | Connection, see. CreateConnection |
| MaxSize | - | Number | ✖ | Maximum data size (bytes). 0 > no limit |
| Marker | - | String, BinaryData | ✖ | End of message marker. Empty > without marker |
| Timeout | - | Number | ✖ | Data waiting timeout (ms). 0 > no limit |
2024-12-16 15:44:01 +03:00
Returns: BinaryData - Received data
<br/>
:::tip
When working with an infinite stream of incoming data, it is obligatory to specify the MaxSize parameter, because endless data retrieval can cause hang-ups
If the connection is closed, an error occurs, or EOF is detected, the read is terminated in either case
Parameters with Binary data type can also accept file paths on disk and URLs
:::
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="1C:Enterprise/OneScript code example"
Address = "45.79.112.203:4242";
Connection = OPI_TCP.CreateConnection(Address);
Message = "Hello server!" + Chars.LF;
Data = ПолучитьДвоичныеДанныеИзСтроки(Message);
OPI_TCP.SendBinaryData(Connection, Data);
// End of message marker to avoid waiting for the end of timeout
Marker = Chars.LF;
Result = OPI_TCP.ReadBinaryData(Connection, , Marker);
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
OPI_TCP.CloseConnection(Connection);
```
2024-12-16 19:16:01 +03:00
2024-12-16 15:44:01 +03:00