Xbase++

Receive a 16-bit Integer from a Socket

Demonstrates Socket.ReceiveInt16, which reads exactly two bytes as a 16-bit integer and stores the result in the ReceivedInt property. Byte order and signedness are selectable.

Background. Fixed-size integers and length prefixes are common building blocks for application-defined binary protocols. Byte order is selectable, with big-endian being network byte order.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oSocket
LOCAL nBTls
LOCAL nMaxWaitMs
LOCAL nBBigEndian
LOCAL nBUnsigned

nSuccess := 0

oSocket := CreateObject("Chilkat.Socket")

//  Connect to the server using TLS.
nBTls := 1
nMaxWaitMs := 5000
nSuccess := oSocket:Connect("example.com", 5000, nBTls, nMaxWaitMs)
IF (nSuccess == 0)
    ? oSocket:LastErrorText
    oSocket:destroy()
    RETURN
ENDIF

//  Read exactly two bytes as a 16-bit integer and store the result in the ReceivedInt property.
//  The 1st argument selects byte order (1 = big-endian); the 2nd selects unsigned interpretation.
nBBigEndian := 1
nBUnsigned := 0
nSuccess := oSocket:ReceiveInt16(nBBigEndian, nBUnsigned)
IF (nSuccess == 0)
    ? oSocket:LastErrorText
    oSocket:destroy()
    RETURN
ENDIF

? "Received 16-bit integer: " + Str(oSocket:ReceivedInt)

oSocket:destroy()