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.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2    Statistic    FMM    Blog  


Writes text to the socket.

Component Version macOS Windows Linux Server iOS SDK
Socket 3.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Socket.WriteHex"; SocketID; Text )   More


Parameter Description Example
SocketID The socket ID received by Socket.Connect function. $sock
Text The text to send in hex encoding. "48656C6C6F"


Returns the number of bytes written or an error message.


Writes text to the socket.
You pass the text hex encoded. For example for "Hello" you pass "48656C6C6F".

Result is -1 if socket can't write. See Socket.LastError for error code.
Changed in v10.4 to return error if socket is closed or disconnected instead of -1.


Write some text:

MBS( "Socket.WriteHex"; $sock; "48656C6C6F" )

Send some command:

// sends
// <STX><6><CMD_ON><channels><CHECKSUM><ETX>
// In Hex : 0x02 0x06 0x4f 0x07 0xa2 0x03

MBS( "Socket.WriteHex"; $sock; "02064F07A203" )

Connect to IP and send command and wait for answer:

Set Variable [$sock; Value:MBS("Socket.Connect";test::IP; 16128)]
If [MBS("IsError")]
    Show Custom Dialog ["Failed to connect"]
    Set Variable [$write; Value:MBS("Socket.WriteHex"; $sock; test::query)]
    Pause/Resume Script [Duration (seconds): 1]
    Set Field [test::response; MBS("Socket.ReadHex"; $sock; 20)]
    Show Custom Dialog ["Hex: " & test::response & ¶ & "Text: " & MBS( "Text.DecodeFromHex"; test::response)]
    Set Variable [$sock; Value:MBS("Socket.Close"; $sock)]
End If

See also

Blog Entries

Created 18th August 2014, last changed 31st August 2020

Socket.WriteByte - Socket.WriteMLLP

Feedback: Report problem or ask question.

MBS Xojo Plugins

Start Chat