Public Member Functions
Socket Class Referenceabstract

#include <Socket.h>

Inheritance diagram for Socket:
TCPSocket UDPSocket

Public Member Functions

virtual ~Socket ()
 
nsapi_error_t open (NetworkStack *stack)
 
nsapi_error_t close ()
 
nsapi_error_t bind (uint16_t port)
 
nsapi_error_t bind (const char *address, uint16_t port)
 
nsapi_error_t bind (const SocketAddress &address)
 
void set_blocking (bool blocking)
 
void set_timeout (int timeout)
 
void sigio (mbed::Callback< void()> func)
 
void attach (mbed::Callback< void()> func)
 
template<typename T , typename M >
void attach (T *obj, M method)
 

Detailed Description

Abstract socket class

Constructor & Destructor Documentation

virtual Socket::~Socket ( )
inlinevirtual

Destroy a socket

Closes socket if the socket is still open

Member Function Documentation

void Socket::attach ( mbed::Callback< void()>  func)

Register a callback on state change of the socket

See also
Socket::sigio
Deprecated:
The behaviour of Socket::attach differs from other attach functions in mbed OS and has been known to cause confusion. Replaced by Socket::sigio.
template<typename T , typename M >
void Socket::attach ( T *  obj,
method 
)
inline

Register a callback on state change of the socket

See also
Socket::sigio
Deprecated:
The attach function does not support cv-qualifiers. Replaced by attach(callback(obj, method)).
nsapi_error_t Socket::bind ( uint16_t  port)

Bind a specific address to a socket

Binding a socket specifies the address and port on which to recieve data.

Parameters
portLocal port to bind
Returns
0 on success, negative error code on failure.
nsapi_error_t Socket::bind ( const char *  address,
uint16_t  port 
)

Bind a specific address to a socket

Binding a socket specifies the address and port on which to recieve data. If the IP address is zeroed, only the port is bound.

Parameters
addressNull-terminated local address to bind
portLocal port to bind
Returns
0 on success, negative error code on failure.
nsapi_error_t Socket::bind ( const SocketAddress &  address)

Bind a specific address to a socket

Binding a socket specifies the address and port on which to recieve data. If the IP address is zeroed, only the port is bound.

Parameters
addressLocal address to bind
Returns
0 on success, negative error code on failure.
nsapi_error_t Socket::close ( )

Close the socket

Closes any open connection and deallocates any memory associated with the socket. Called from destructor if socket is not closed.

Returns
0 on success, negative error code on failure
nsapi_error_t Socket::open ( NetworkStack *  stack)

Opens a socket

Creates a network socket on the network stack of the given network interface. Not needed if stack is passed to the socket's constructor.

Parameters
stackNetwork stack as target for socket
Returns
0 on success, negative error code on failure
void Socket::set_blocking ( bool  blocking)

Set blocking or non-blocking mode of the socket

Initially all sockets are in blocking mode. In non-blocking mode blocking operations such as send/recv/accept return NSAPI_ERROR_WOULD_BLOCK if they can not continue.

set_blocking(false) is equivalent to set_timeout(-1) set_blocking(true) is equivalent to set_timeout(0)

Parameters
blockingtrue for blocking mode, false for non-blocking mode.
void Socket::set_timeout ( int  timeout)

Set timeout on blocking socket operations

Initially all sockets have unbounded timeouts. NSAPI_ERROR_WOULD_BLOCK is returned if a blocking operation takes longer than the specified timeout. A timeout of 0 removes the timeout from the socket. A negative value give the socket an unbounded timeout.

set_timeout(0) is equivalent to set_blocking(false) set_timeout(-1) is equivalent to set_blocking(true)

Parameters
timeoutTimeout in milliseconds
void Socket::sigio ( mbed::Callback< void()>  func)

Register a callback on state change of the socket

The specified callback will be called on state changes such as when the socket can recv/send/accept successfully and on when an error occurs. The callback may also be called spuriously without reason.

The callback may be called in an interrupt context and should not perform expensive operations such as recv/send calls.

Note! This is not intended as a replacement for a poll or attach-like asynchronous api, but rather as a building block for constructing such functionality. The exact timing of when the registered function is called is not guaranteed and susceptible to change.

Parameters
funcFunction to call on state change

The documentation for this class was generated from the following files: