Selector.hpp
1
2//
3// SFML - Simple and Fast Multimedia Library
4// Copyright (C) 2007-2009 Laurent Gomila (laurent.gom@gmail.com)
5//
6// This software is provided 'as-is', without any express or implied warranty.
7// In no event will the authors be held liable for any damages arising from the use of this software.
8//
9// Permission is granted to anyone to use this software for any purpose,
10// including commercial applications, and to alter it and redistribute it freely,
11// subject to the following restrictions:
12//
13// 1. The origin of this software must not be misrepresented;
14// you must not claim that you wrote the original software.
15// If you use this software in a product, an acknowledgment
16// in the product documentation would be appreciated but is not required.
17//
18// 2. Altered source versions must be plainly marked as such,
19// and must not be misrepresented as being the original software.
20//
21// 3. This notice may not be removed or altered from any source distribution.
22//
24
25#ifndef SFML_SELECTOR_HPP
26#define SFML_SELECTOR_HPP
27
29// Headers
31#include <SFML/Network/SocketUDP.hpp>
32#include <SFML/Network/SocketTCP.hpp>
33#include <SFML/Network/SelectorBase.hpp>
34#include <map>
35
36
37namespace sf
38{
39
43template <typename Type>
44class Selector : private SelectorBase
46public :
47
54 void Add(Type Socket);
55
60 ///
61 ////////////////////////////////////////////////////////////
62 void Remove(Type Socket);
63
65
68 void Clear();
69
73 /// is ready, or when the given time is out
74 ///
75 /// \param Timeout : Timeout, in seconds (0 by default : no timeout)
76 ///
77 /// \return Number of sockets ready to be read
78 ///
79 ////////////////////////////////////////////////////////////
80 unsigned int Wait(float Timeout = 0.f);
81
89 /// \return The Index-th socket
90 ///
91 ////////////////////////////////////////////////////////////
92 Type GetSocketReady(unsigned int Index);
93
94private :
95
97 // Types
99 typedef std::map<SocketHelper::SocketType, Type> SocketTable;
100
102 // Member data
104 SocketTable mySockets;
105};
106
107#include <SFML/Network/Selector.inl>
108
109// Let's define the two only valid types of Selector
110typedef Selector<SocketUDP> SelectorUDP;
111typedef Selector<SocketTCP> SelectorTCP;
112
113} // namespace sf
114
115
116#endif // SFML_SELECTOR_HPP
SelectorBase()
Default constructor.
Selector allow reading from multiple sockets without blocking.
Definition Selector.hpp:45
void Clear()
Remove all sockets.
Definition Selector.hpp:60
void Remove(Type Socket)
Remove a socket.
Definition Selector.hpp:45
Type GetSocketReady(unsigned int Index)
After a call to Wait(), get the Index-th socket which is ready for reading.
Definition Selector.hpp:89
void Add(Type Socket)
Add a socket to watch.
Definition Selector.hpp:31
unsigned int Wait(float Timeout=0.f)
Wait and collect sockets which are ready for reading.
Definition Selector.hpp:73