Xbase++

Receive Text up to a Matching Sequence

Demonstrates Socket.ReceiveUntilMatch, which receives bytes until an exact byte sequence is found. The match string is encoded using StringCharset and compared byte-for-byte.

Background. The comparison is case-sensitive with no Unicode normalization. This is useful for reading a message that ends with an application-defined marker delimiting the end of a response.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oSocket
LOCAL nBTls
LOCAL nMaxWaitMs
LOCAL cCommand
LOCAL cResponse

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 bytes until an exact byte sequence is found.  The match string is encoded using
//  StringCharset and compared byte-for-byte.  Here the server marks the end of its response with an
//  application-defined marker.
cResponse := oSocket:ReceiveUntilMatch("<EOM>")
IF (oSocket:LastMethodSuccess == 0)
    ? oSocket:LastErrorText
    oSocket:destroy()
    RETURN
ENDIF

? cResponse

oSocket:destroy()