Receive a String from a Socket

See more Socket/SSL/TLS Examples

Demonstrates Socket.ReceiveString, which receives text and decodes it using StringCharset. It returns the first nonempty decoded result rather than draining all available data.

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 text and decode it using StringCharset.  ReceiveString returns the first nonempty decoded
    ;  result; it does not keep reading to drain all available data.
    responseText.s = CkSocket::ckReceiveString(socket)
    If CkSocket::ckLastMethodSuccess(socket) = 0
        Debug CkSocket::ckLastErrorText(socket)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    Debug responseText


    CkSocket::ckDispose(socket)


    ProcedureReturn
EndProcedure