Receive Text up to a Delimiter Byte

See more Socket/SSL/TLS Examples

Demonstrates Socket.ReceiveStringUntilByte, which receives bytes until a specific raw byte value is found, then decodes the preceding bytes using StringCharset. The delimiter is excluded from the returned string.

IncludeFile "CkSocket.pb"

Procedure ChilkatExample()

    success.i = 0

    socket.i = CkSocket::ckCreate()
    If socket.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ;  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.
    bTls.i = 1
    maxWaitMs.i = 5000
    success = CkSocket::ckConnect(socket,"example.com",5000,bTls,maxWaitMs)
    If success = 0
        Debug CkSocket::ckLastErrorText(socket)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    ;  StringCharset controls the character encoding used when sending and receiving text.
    CkSocket::setCkStringCharset(socket, "utf-8")
    ;  Send a request using a simple application-defined text protocol in which each message ends with a
    ;  CRLF.
    command.s = "STATUS" + Chr(13) + Chr(10)
    success = CkSocket::ckSendString(socket,command)
    If success = 0
        Debug CkSocket::ckLastErrorText(socket)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    ;  Receive bytes until a specific raw byte value is found, then decode the preceding bytes using
    ;  StringCharset.  The delimiter itself is excluded from the returned string.  Here the delimiter is
    ;  the linefeed byte (decimal 10).
    line.s = CkSocket::ckReceiveStringUntilByte(socket,10)
    If CkSocket::ckLastMethodSuccess(socket) = 0
        Debug CkSocket::ckLastErrorText(socket)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    Debug line


    CkSocket::ckDispose(socket)


    ProcedureReturn
EndProcedure