Xbase++

Receive Text from a Socket into a StringBuilder

Demonstrates Socket.ReceiveSb, which receives text, decodes it using StringCharset, and appends it to a StringBuilder.

Background. Text send and receive operations encode and decode bytes using the StringCharset property. For plain ASCII or UTF-8 protocols, setting StringCharset to utf-8 is a safe default.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oSocket
LOCAL nBTls
LOCAL nMaxWaitMs
LOCAL cCommand
LOCAL oSb
LOCAL cResponseText

nSuccess := 0

oSocket := CreateObject("Chilkat.Socket")

//  Connect to the server using TLS.  The 3rd argument enables the TLS handshake after the TCP
//  connection succeeds; the 4th is the maximum time to wait, in milliseconds.
nBTls := 1
nMaxWaitMs := 5000
nSuccess := oSocket:Connect("example.com", 5000, nBTls, nMaxWaitMs)
IF (nSuccess == 0)
    ? oSocket:LastErrorText
    oSocket:destroy()
    RETURN
ENDIF

//  StringCharset controls the character encoding used when sending and receiving text.
oSocket:StringCharset := "utf-8"
//  Send a request using a simple application-defined text protocol in which each message ends with a
//  CRLF.
cCommand := "STATUS" + Chr(13) + Chr(10)
nSuccess := oSocket:SendString(cCommand)
IF (nSuccess == 0)
    ? oSocket:LastErrorText
    oSocket:destroy()
    RETURN
ENDIF

//  Receive text and append it to a StringBuilder, decoding using StringCharset.
oSb := CreateObject("Chilkat.StringBuilder")
nSuccess := oSocket:ReceiveSb(oSb)
IF (nSuccess == 0)
    ? oSocket:LastErrorText
    oSocket:destroy()
    oSb:destroy()
    RETURN
ENDIF

cResponseText := oSb:GetAsString()
IF (oSb:LastMethodSuccess == 0)
    ? oSb:LastErrorText
    oSocket:destroy()
    oSb:destroy()
    RETURN
ENDIF

? cResponseText

oSocket:destroy()
oSb:destroy()