Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.2   7.3   7.4   7.5   8.0   8.1   8.2   8.3   8.4   8.5    Statistic  

Socket.ReadLine

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

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Socket 4.3 Yes Yes Yes Yes Yes
MBS( "Socket.ReadLine"; SocketID; Delimiter { ; Encoding } )   More

Parameters

Parameter Description Example value
SocketID The socket ID received by Socket.Connect 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 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.
Possible encoding names: ANSI, Arabic-Mac, Arabic-Win, Baltic-Win, CentralEurope-Mac, ChineseSimp-Mac, ChineseSimp-Win, ChineseTrad-Mac, ChineseTrad-Win, Cyrillic-Mac, Cyrillic-Win, EasternEurope-Win, Greek-Mac, Greek-Win, Hebrew-Mac, Hebrew-Win, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-15, Korean-Johab, Korean-Mac, Korean-Win, Latin1, Mac, Native, ShiftJIS-Mac, ShiftJIS-Win, Turkish-Mac, Turkish-Win, UTF-8, DOS or Windows. Pass native to use the native encoding of the current platform.
UTF8

Result

Returns OK 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"; $sock; 13; "windows" )

See also

Created 11st September 2014, last changed 12nd November 2015


Socket.ReadHex   -   Socket.ReadLineHex

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins