Socket.Peek
-----------

Peeks bytes from socket and returns them as text.

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

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

**MBS**( **"Socket.Peek";** /\* Peeks bytes from socket and returns them as text. \*/  
**$SocketID**; /\* The socket ID received by [Socket.Connect](SocketConnect.md) function.e.g. $sock \*/   
**$Length**; /\* Maximum number of bytes to read.e.g. 10 \*/   
**$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 |  |
| 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](https://www.monkeybreadsoftware.com/filemaker/faq.shtml). | 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](SocketPeekAll.md) function.  
### Examples

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

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

- [Socket.Check](SocketCheck.md)
- [Socket.Connect](SocketConnect.md)
- [Socket.PeekAll](SocketPeekAll.md)
- [Socket.PeekHex](SocketPeekHex.md)
- [Socket.Read](SocketRead.md)
- [Socket.ReadAll](SocketReadAll.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)

This function is free to use.

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

  
[Socket.NewUDPSocket](SocketNewUDPSocket.md) - [Socket.PeekAll](SocketPeekAll.md)

[HTML Version](SocketPeek.shtml)