You've already forked OpenIntegrations
mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2025-11-25 22:12:29 +02:00
65 lines
2.0 KiB
Plaintext
Vendored
65 lines
2.0 KiB
Plaintext
Vendored
---
|
|
sidebar_position: 3
|
|
description: Read binary data and other functions to work with TCP in the Open Integration Package, a free open-source integration library for 1C:Enterprise 8, OneScript and CLI
|
|
keywords: [1C, 1С, 1С:Enterprise, 1С:Enterprise 8.3, API, Integration, Services, Exchange, OneScript, CLI, TCP]
|
|
---
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
# Read binary data
|
|
Reads data from the specified connection
|
|
|
|
|
|
|
|
`Function ReadBinaryData(Val Connection, Val MaxSize = 0, Val Marker = "", Val Timeout = 5000) Export`
|
|
|
|
| Parameter | CLI option | Type | Required | Description |
|
|
|-|-|-|-|-|
|
|
| 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 |
|
|
|
|
|
|
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
|
|
:::
|
|
|
|
:::caution
|
|
**NOCLI:** this method is not available in CLI version
|
|
:::
|
|
<br/>
|
|
|
|
|
|
```bsl title="1C:Enterprise/OneScript code example"
|
|
Address = "45.79.112.203:4242";
|
|
Connection = OPI_TCP.CreateConnection(Address);
|
|
Message = "Hello server!" + Chars.LF;
|
|
Data = GetBinaryDataFromString(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);
|
|
```
|
|
|
|
|
|
|
|
|
|
```json title="Result"
|
|
"Hello server!\n"
|
|
```
|