2024-12-16 15:44:01 +03:00
---
sidebar_position: 4
2025-05-05 11:15:20 +03:00
description: Read line 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
2025-05-05 09:49:19 +03:00
keywords: [1C, 1С, 1С:Enterprise, 1С:Enterprise 8.3, API, Integration, Services, Exchange, OneScript, CLI, TCP]
2024-12-16 15:44:01 +03:00
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
2024-12-16 16:30:49 +03:00
# Read line
Reads data from the specified connection as a string
2024-12-16 15:44:01 +03:00
`Function ReadLine(Val Connection, Val Encoding = "UTF-8", 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 |
| Encoding | - | String | ✖ | Encoding of data conversion to string |
| 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: String - Received data as string
<br/>
:::tip
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-25 13:09:29 +03:00
**NOCLI:** this method is not available in CLI version
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"
2025-06-29 14:35:33 +03:00
Address = "45.79.112.203:4242";
2024-12-17 14:53:37 +03:00
Connection = OPI_TCP.CreateConnection(Address);
Data = "Hello server!" + Chars.LF;
2024-12-16 15:44:01 +03:00
2024-12-17 14:53:37 +03:00
OPI_TCP.SendLine(Connection, Data);
// End of message marker to avoid waiting for the end of timeout
Marker = Chars.LF;
Result = OPI_TCP.ReadLine(Connection, , Marker);
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
OPI_TCP.CloseConnection(Connection);
2024-12-16 15:44:01 +03:00
```
2024-12-16 19:16:01 +03:00
2024-12-16 15:44:01 +03:00
2024-12-20 11:20:56 +03:00
```json title="Result"
"Hello server!\n"
```