Socket.ReadLine
---------------

Reads a line of data from socket and returns them as text.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Socket](component_Socket.md) | [4.3](newinversion43.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "Socket.ReadLine"; SocketID; Delimiter { ; Encoding } ) 

**MBS**( **"Socket.ReadLine";** /\* Reads a line of data from socket and returns them as text. \*/  
**$SocketID**; /\* The socket ID received by [Socket.Connect](SocketConnect.md) function.e.g. $sock \*/   
**$Delimiter**; /\* Which character to use as delimiter.   
Pass number from 0 to 255 for the byte to use. e.g. 13 for CR line ending. Special handling is done if you pass 1310 as delimiter to cover CRLF as a 2 byte delimiter.e.g. 13 \*/   
**$Encoding**) /\* Optional; The text encoding for result.   
Default is native. This function can also handle UTF-16 as well as UTF-16LE and UTF-16BE for little/big endian byte order.e.g. UTF8 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| SocketID | The socket ID received by [Socket.Connect](SocketConnect.md) function. | $sock |  |
| Delimiter | Which character to use as delimiter.    Pass number from 0 to 255 for the byte to use. e.g. 13 for CR line ending. Special handling is done if you pass 1310 as delimiter to cover CRLF as a 2 byte delimiter. | 13 |  |
| Encoding | The text encoding for result.    Default is native. This function can also handle UTF-16 as well as UTF-16LE and UTF-16BE for little/big endian byte order.   Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the [FAQ](https://www.monkeybreadsoftware.com/filemaker/faq.shtml). | UTF8 | Optional |

### Result

Returns text or error.

### Description

Reads a line of data from socket and returns them as text.  
The delimiter allows you to read from the buffer just one line. If two lines are in read buffer, we leave second line there for the next call.  
### Examples

Read one line and decode them from Windows text encoding into FileMaker:

 $value = MBS ( "[Socket.Read](SocketRead.md)"; $sock ; 13; "windows" )  
### See also

- [Socket.Connect](SocketConnect.md)
- [Socket.Read](SocketRead.md)
- [Socket.ReadAll](SocketReadAll.md)
- [Socket.ReadHex](SocketReadHex.md)
- [Socket.ReadLineHex](SocketReadLineHex.md)
- [Socket.ReadMLLP](SocketReadMLLP.md)

### Blog Entries

- [Socket changes for MBS FileMaker Plugin](https://www.mbsplugins.de/archive/2020-08-31/Socket_changes_for_MBS_FileMak/monkeybreadsoftware_blog_filemaker)
- [MBS Filemaker Plugin, version 4.3pr11](https://www.mbsplugins.de/archive/2014-09-14/MBS_Filemaker_Plugin_version_4/monkeybreadsoftware_blog_filemaker)

This function is free to use.

Created 11st September 2014 , last changed 9th November 2021

  
[Socket.ReadHex](SocketReadHex.md) - [Socket.ReadLineHex](SocketReadLineHex.md)

[HTML Version](SocketReadLine.shtml)