QueuedConnectionReader

class QueuedConnectionReader

Bases: ConnectionReader, QueuedReturn< NetDatagram >

This flavor of ConnectionReader will read from its sockets and queue up all of the datagrams read for later receipt by the client code. This class is useful for client code that doesn’t want to deal with threading and is willing to poll for datagrams at its convenience.

Inheritance diagram

explicit QueuedConnectionReader(ConnectionManager *manager, int num_threads)

bool data_available(void)

Returns true if a datagram is available on the queue; call get_data() to extract the datagram.

bool get_data(NetDatagram &result)

bool get_data(Datagram &result)

If a previous call to data_available() returned true, this function will return the datagram that has become available.

The return value is true if a datagram was successfully returned, or false if there was, in fact, no datagram available. (This may happen if there are multiple threads accessing the QueuedConnectionReader).

This flavor of QueuedConnectionReader::get_data(), works like the other, except that it only fills a Datagram object, not a NetDatagram object. This means that the Datagram cannot be queried for its source Connection and/or NetAddress, but it is useful in all other respects.