Version 5.0 The LEDA User Manual

4.13 Sockets ( leda socket )
1. Definition
A data packet consists of a sequence of bytes (in C of type unsigned char)
c 0 , c 1 , c 2 , c 3 , x 1 , . . . , x n . The first four bytes encode the number n of the following bytes
such that n = c 0 + c 1 · 2 8 + c 2 · 2 16 + c 3 · 2 24 . The LEDA data type leda socket offers,
in addition to the operations for establishing a socket connection, functions for sending
and receiving packets across such a connection. It is also possible to set a receive limit;
if such a receive limit is set, messages longer than the limit will be refused. If the limit is
negative (default), no messages will be refused.
In particular, the following operations are available:
#include < LEDA/system/socket.h >
2. Creation
leda socket S(const char ∗ host, int port);
leda socket S(const char ∗ host);
creates an instance S of type leda socket associated with host name
host and port number port.
creates an instance S of type leda socket associated with host name
host.
leda socket S;
creates an instance S of type leda socket.
3. Operations
void
S.set host(const char ∗ host)
sets the host name to host.
void S.set port(int port) sets the port number to port.
int S.get limit( ) returns the receive limit parameter.
void S.set limit(int limit) sets the receive limit parameter to limit. If a negative
limit is set, the limit parameter will be ignored.
void
void
void
S.set qlength(int len) sets the queue length to len.
S.set timeout(int sec)
sets the timeout interval to sec seconds.
S.set error handler(void (∗f)(leda socket& , string))
sets the error handler to function f.