SC::SocketServer Struct Reference

Use a SocketDescriptor as a Server (example TCP or UDP Socket Server). More...

#include <Socket.h>

Public Types
enum class	BindReuseAddress : uint8_t {   Disabled ,   Enabled }
enum class	BindStatus : uint8_t {   None ,   AddressInUse }

Public Member Functions
	SocketServer (SocketDescriptor &socket)
	Build a SocketServer from a SocketDescriptor (already created with SocketDescriptor::create)
ResultSocket	close ()
	Calls SocketDescriptor::close.
ResultSocket	bind (const SocketAddress &nativeAddress, BindReuseAddress reuseAddress=BindReuseAddress::Enabled, BindStatus *outStatus=nullptr)
	Binds this socket to an address.
ResultSocket	bind (SocketIPAddress nativeAddress, BindReuseAddress reuseAddress=BindReuseAddress::Enabled, BindStatus *outStatus=nullptr)
	IP-address compatibility overload for bind.
ResultSocket	listen (uint32_t numberOfWaitingConnections)
	Start listening for incoming connections at a specific address / port combination (after bind)
ResultSocket	accept (SocketFlags::AddressFamily addressFamily, SocketDescriptor &newClient)
	Accepts a new client, blocking while waiting for it.
ResultSocket	accept (SocketDescriptor &newClient, SocketAddress *peerAddress=nullptr)
	Accepts a new client and optionally reports its peer address.

Detailed Description

Use a SocketDescriptor as a Server (example TCP or UDP Socket Server).

Example:

    SocketDescriptor serverSocket;
    SocketServer     server(serverSocket);
 
    // Look for an available port
    constexpr int    tcpPort       = 5050;
    const StringView serverAddress = "::1"; // or "127.0.0.1"
    SocketIPAddress  nativeAddress;
    SC_TRY(nativeAddress.fromAddressPort(serverAddress, tcpPort));
    SocketFlags::AddressFamily family = nativeAddress.getAddressFamily();
 
    // Create socket and start listening
    SC_TRY(serverSocket.create(family)); // By default creates a TCP Server
 
    // [Alternatively] Create an UDP socket instead
    // SC_TRY(serverSocket.create(family, SocketFlags::SocketDgram, SocketFlags::ProtocolUdp));
 
    SC_TRY(server.bind(nativeAddress)); // Bind the socket to the given address
    SC_TRY(server.listen(1));           // Start listening (skip this for UDP sockets)
 
    // Accept a client
    SocketDescriptor acceptedClientSocket;
    SC_TRY(server.accept(family, acceptedClientSocket));
    SC_TRY(acceptedClientSocket.isValid());
 
    // ... Do something with acceptedClientSocket

Constructor & Destructor Documentation

SocketServer()

SC::SocketServer::SocketServer ( SocketDescriptor & socket )

inline

Build a SocketServer from a SocketDescriptor (already created with SocketDescriptor::create)

Parameters

socket

A socket descriptor created with SocketDescriptor::create to be used as server

Member Function Documentation

accept() [1/2]

ResultSocket SC::SocketServer::accept	(	SocketDescriptor &	newClient,
		SocketAddress *	peerAddress = nullptr )

Accepts a new client and optionally reports its peer address.

accept() [2/2]

ResultSocket SC::SocketServer::accept	(	SocketFlags::AddressFamily	addressFamily,
		SocketDescriptor &	newClient )

Accepts a new client, blocking while waiting for it.

Parameters

[in]	addressFamily	Compatibility parameter; the accepted descriptor family is inherited from the listener
[out]	newClient	The SocketDescriptor that will be accepted

Returns

Valid Result if the socket has been successfully accepted

bind() [1/2]

ResultSocket SC::SocketServer::bind	(	const SocketAddress &	nativeAddress,
		BindReuseAddress	reuseAddress = BindReuseAddress::Enabled,
		BindStatus *	outStatus = nullptr )

Binds this socket to an address.

Parameters

nativeAddress	The local address to bind
reuseAddress	Whether SO_REUSEADDR should be set before binding
outStatus	Optional detailed status for bind failures

Returns

Valid Result if this socket has successfully been bound

bind() [2/2]

ResultSocket SC::SocketServer::bind	(	SocketIPAddress	nativeAddress,
		BindReuseAddress	reuseAddress = BindReuseAddress::Enabled,
		BindStatus *	outStatus = nullptr )

IP-address compatibility overload for bind.

close()

ResultSocket SC::SocketServer::close

(

)

Calls SocketDescriptor::close.

Returns

The Result of SocketDescriptor::close

listen()

ResultSocket SC::SocketServer::listen

(

uint32_t

numberOfWaitingConnections

)

Start listening for incoming connections at a specific address / port combination (after bind)

Parameters

numberOfWaitingConnections

How many connections can be queued before accept

Returns

Valid Result if this socket has successfully been put in listening mode

Note

Datagram sockets cannot be listened. Stream sockets need a successful bind before listen

---

The documentation for this struct was generated from the following file:

• Socket.h