RWSocketListener Class Reference
[Essential Networking Module]

Waits on a specified socket address for incoming connections. More...

#include <rw/network/RWSocketListener.h>

Inheritance diagram for RWSocketListener:

List of all members.

Public Member Functions
	RWSocketListener ()
	RWSocketListener (const RWSockAddrBase &address, int backlog=5)
	RWSocketListener (const RWSocket &socket, WhoShouldClose who=Portal)
	~RWSocketListener ()
void	listen (const RWSockAddrBase &address, int backlog=5)
RWSocketPortal	accept (RWSockAddr *addr=0) const
RWSocketPortal	operator() (RWSockAddr *addr=0) const
RWSocket	getSocket () const

---

Detailed Description

Waits on a specified socket address for incoming connections. Connections are obtained as RWSocketPortal instances.

---

Constructor & Destructor Documentation

RWSocketListener::RWSocketListener

(

)

Creates an uninitialized socket listener. Self needs to be initialized using listen() before it can be used.

RWSocketListener::RWSocketListener	(	const RWSockAddrBase &	address,
		int	backlog = 5
	)

Sets up a listener on the address indicated, and sets up a queue to wait for connections. The backlog parameter specifies the number of incoming connection requests that the protocol software enqueues while a connection is being processed.

RWSocketListener::RWSocketListener	(	const RWSocket &	socket,
		WhoShouldClose	who = Portal
	)

Creates a listening portal to the communications channel, where socket is the socket doing the listening. Using this constructor is the only way to create a socket that is not closed automatically when portals are no longer using it.

RWSocketListener::~RWSocketListener

(

)

Destructor.

---

Member Function Documentation

RWSocketPortal RWSocketListener::accept

(

RWSockAddr *

addr = 0

)

const

Receives the next waiting connection. The address of the connecting client will be stored in the RWSockAddr referenced by addr.

RWSocket RWSocketListener::getSocket

(

)

const

Obtains a reference to the underlying socket.

void RWSocketListener::listen	(	const RWSockAddrBase &	address,
		int	backlog = 5
	)

Binds the listener to the address indicated, and sets up a queue to wait for connections. The backlog parameter specifies the number of incoming connection requests that the protocol software enqueues while a connection is being processed.

RWSocketPortal RWSocketListener::operator()

(

RWSockAddr *

addr = 0

)

const

Receives the next waiting connection. The address of the connecting client will be stored in the RWSockAddr referenced by addr.