class UDPSocket

Overview

A User Datagram Protocol socket. UDP runs on top of the Internet Protocol (IP) and was developed for applications that do not require reliability, acknowledgement, or flow control features at the transport layer. This simple protocol provides transport layer addressing in the form of UDP ports and an optional checksum capability.

UDP is a very simple protocol. Messages, so called datagrams, are sent to other hosts on an IP network without the need to set up special transmission channels or data paths beforehand. The UDP socket only needs to be opened for communication. It listens for incoming messages and sends outgoing messages on request.

This implementation supports both IPv4 and IPv6 addresses. For IPv4 addresses you need use Socket::Family::INET family (used by default). And Socket::Family::INET6 for IPv6 addresses accordingly.

Usage example:

require "socket"

# Create server
server = UDPSocket.new
server.bind "localhost", 1234

# Create client and connect to server
client = UDPSocket.new
client.connect "localhost", 1234

client << "message" # send message to server
server.read(7)      # => "message"

# Close client and server
client.close
server.close

Superclass hierarchy

Defined in:

Class Method Summary

.new(family = Socket::Family::INET : Socket::Family)

Instance Method Summary

#bind(host, port)
Creates a UDP socket from the given address.
#connect(host, port)
Attempts to connect the socket to a remote address and port for this socket.

Class Method Detail

def self.new(family = Socket::Family::INET : Socket::Family)

Instance Method Detail

def bind(host, port)

Creates a UDP socket from the given address.

server = UDPSocket.new
server.bind "localhost", 1234

def connect(host, port)

Attempts to connect the socket to a remote address and port for this socket.

client = UDPSocket.new
client.connect "localhost", 1234