Receive a Bounded String from a Socket

See more Socket/SSL/TLS Examples

Demonstrates Socket.ReceiveStringMaxN, which receives and decodes text like ReceiveString but reads at most a given number of input bytes.

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 and decode text like ReceiveString, but read at most the given number of input bytes.
    ;  The limit is measured in bytes, not Unicode characters.
    firstChunk.s = CkSocket::ckReceiveStringMaxN(socket,64)
    If CkSocket::ckLastMethodSuccess(socket) = 0
        Debug CkSocket::ckLastErrorText(socket)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    Debug firstChunk


    CkSocket::ckDispose(socket)


    ProcedureReturn
EndProcedure