Ruby

Send a String over a Socket

Demonstrates Socket.SendString, which encodes a string using StringCharset and sends the resulting bytes over the connected socket. No delimiter, terminator, or length prefix is added.

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")

#  Encode the string using StringCharset and send the resulting bytes.  No delimiter, terminator, or
#  length prefix is added; the exact bytes are sent.  This example sends a command for a simple
#  application-defined text protocol.
message = "STATUS\r\n"
success = socket.SendString(message)
if (success == false)
    print socket.lastErrorText() + "\n";
    exit
end

print "Message sent." + "\n";