Monkeybread Software - MBS FileMaker Plugin: Socket.Peek

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

Socket.Peek

Peeks bytes from socket and returns them as text.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
Socket	3.1	Yes	Yes	Yes	Yes	Yes

MBS( "Socket.Peek"; SocketID; length { ; Encoding } ) More

Parameters

Parameter Description Example Flags

SocketID The socket ID received by Socket.Connect function. $sock

length Maximum number of bytes to read. 10

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. UTF8 Optional

Parameter	Description	Example	Flags
SocketID	The socket ID received by Socket.Connect function.	$sock
length	Maximum number of bytes to read.	10
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.	UTF8	Optional

Result

Returns text or error message.

Description

Peeks bytes from socket and returns them as text.
The text returned may be shorter than length bytes.

If you like to look into the whole buffer, please use Socket.PeekAll function.

Examples

Read up to 8 bytes and decode them from Windows text encoding into FileMaker:

$value = MBS( "Socket.Read"; $sock; 8; "windows" )

Blog Entries

Socket changes for MBS FileMaker Plugin

Created 18th August 2014, last changed 15th February 2019

Socket.NewUDPSocket - Socket.PeekAll