Ruby

Receive a String from a Socket

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

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 Ruby Downloads

Download Chilkat for Ruby

Ruby

require 'chilkat'

success = false

socket = Chilkat::CkSocket.new()

#  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 = true
maxWaitMs = 5000
success = socket.Connect("example.com",5000,bTls,maxWaitMs)
if (success == false)
    print socket.lastErrorText() + "\n";
    exit
end

#  StringCharset controls the character encoding used when sending and receiving text.
socket.put_StringCharset("utf-8")
#  Send a request using a simple application-defined text protocol in which each message ends with a
#  CRLF.
command = "STATUS\r\n"
success = socket.SendString(command)
if (success == false)
    print socket.lastErrorText() + "\n";
    exit
end

#  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 = socket.receiveString()
if (socket.get_LastMethodSuccess() == false)
    print socket.lastErrorText() + "\n";
    exit
end

print responseText + "\n";