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.Read

Reads bytes from socket and returns them as text.

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

Result

Returns text or error message.

Description

Examples

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

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

Connect to a HTTP Server and wait for answer:

Set Variable [$r; Value:MBS("Trace")]
Set Variable [$sock; Value:MBS("Socket.Connect"; TCP Socket::DomainOrIP; 80)]
If [MBS("IsError")]
    Show Custom Dialog ["Error"; $sock]
    Exit Script []
End If
Set Variable [$request; Value:"GET "&TCP Socket::Path&" HTTP/1.0¶Host: "&TCP Socket::DomainOrIP&"¶¶"]
Set Variable [$request; Value:MBS("String.ReplaceNewline"; $request; 2)]
Set Field [TCP Socket::RequestUsed; $request]
Set Variable [$r; Value:MBS("Socket.Write"; $sock; $request)]
Pause/Resume Script [Duration (seconds): 1]
Set Variable [$data; Value:MBS("Socket.Read"; $sock; 1000)]
Set Variable [$data; Value:MBS("String.ReplaceNewline"; $data; 1)]
Set Field [TCP Socket::Result; $data]
Set Variable [$r; Value:MBS("Socket.Close"; $sock)]

Read data and put in a new record:

Set Variable [$r; Value:MBS("Socket.Read"; $$sock; 1500; "UTF-8")]
If [MBS("IsError")]
    Show Custom Dialog ["Error Reading"; $r]
Else If [Length($r) = 0]
    Show Custom Dialog ["Error Reading"; "No data available."]
Else
    New Record/Request
    Set Field [UDP Broadcast::Message Received; $r]
    Set Field [UDP Broadcast::Sender; MBS("Socket.LastMessageIP"; $$sock)]
    Commit Records/Requests [No dialog]
End If

See also

• Socket.LastMessageIP
• Socket.PeekAllHex
• Socket.ReadAll
• Socket.ReadAllHex
• Socket.ReadHex
• Socket.ReadLine
• Socket.ReadLineHex
• Socket.ReadMLLP
• Socket.SetDataAvailableEvaluate
• Socket.Write

Example Databases

• Network/HTTP Server hosted
• Network/HTTP Server local
• Network/Socket Test/Socket Test
• Network/SSL/TCP Socket SSL
• Network/TCP Send and Receive/TCP Receiver
• Network/TCP Send and Receive/TCP Sender
• Network/TCP Socket
• Network/UDP/UDP Broadcast
• Network/UDP/UDP Receiver

Blog Entries

• MBS FileMaker Plugin, version 10.4pr7
• Socket changes for MBS FileMaker Plugin
• MBS Filemaker Plugin, version 3.2pr3

Release notes

• Version 10.4
  • Improved Socket functions to better return errors. Socket.AvailableBytes, Socket.Write or Socket.Read functions now return an error when socket is disconnected or otherwise broken.

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

Socket.PeekHex   -   Socket.ReadAll

Feedback: Report problem or ask question.