network_gamelist.h File Reference

Handling of the list of games. More...

#include "core/address.h"
#include "core/network_game_info.h"
#include "network_type.h"

Go to the source code of this file.

Data Structures
struct	NetworkGame
	Structure with information shown in the game list (GUI). More...

Enumerations
enum class	NetworkGameStatus : uint8_t {   Offline , Online , Full , Banned ,   TooOld }
	The status a server can be in. More...

Functions
NetworkGame *	NetworkGameListAddItem (std::string_view connection_string)
	Add a new item to the linked gamelist.
void	NetworkGameListRemoveItem (NetworkGame *remove)
	Remove an item from the gamelist linked list.
void	NetworkGameListRemoveExpired ()
	Remove all servers that have not recently been updated.

Variables
std::vector< std::unique_ptr< NetworkGame > >	_network_game_list
	Game list of this client.
int	_network_game_list_version
	Current version of all items in the list.

Detailed Description

Handling of the list of games.

Definition in file network_gamelist.h.

Enumeration Type Documentation

NetworkGameStatus

enum class NetworkGameStatus : uint8_t

strong

The status a server can be in.

Enumerator
Offline	Server is offline (or cannot be queried).
Online	Server is online.
Full	Server is full and cannot be queried.
Banned	You are banned from this server.
TooOld	Server is too old to query.

Definition at line 18 of file network_gamelist.h.

Function Documentation

NetworkGameListAddItem()

NetworkGame * NetworkGameListAddItem

(

std::string_view

connection_string

)

Add a new item to the linked gamelist.

If the IP and Port match return the existing item instead of adding it again

Parameters

connection_string

the address of the to-be added item

Returns

a point to the newly added or already existing item

Definition at line 27 of file network_gamelist.cpp.

References _network_game_list, _network_game_list_version, NetworkGame::connection_string, ServerAddress::connection_string, NETWORK_DEFAULT_PORT, ServerAddress::Parse(), and UpdateNetworkGameWindow().

Referenced by QueryNetworkGameSocketHandler::CloseConnection(), NetworkAddServer(), NetworkQueryServer(), TCPQueryConnecter::OnFailure(), ClientNetworkCoordinatorSocketHandler::ReceiveGameCoordinatorError(), ClientNetworkCoordinatorSocketHandler::ReceiveGameCoordinatorListing(), QueryNetworkGameSocketHandler::ReceiveServerBanned(), QueryNetworkGameSocketHandler::ReceiveServerError(), QueryNetworkGameSocketHandler::ReceiveServerFull(), and QueryNetworkGameSocketHandler::ReceiveServerGameInfo().

NetworkGameListRemoveExpired()

void NetworkGameListRemoveExpired

(

)

Remove all servers that have not recently been updated.

Call this after you received all the servers from the Game Coordinator, so the ones that are no longer listed are removed.

Definition at line 65 of file network_gamelist.cpp.

References _network_game_list, _network_game_list_version, and UpdateNetworkGameWindow().

Referenced by ClientNetworkCoordinatorSocketHandler::ReceiveGameCoordinatorListing().

NetworkGameListRemoveItem()

void NetworkGameListRemoveItem

(

NetworkGame *

remove

)

Remove an item from the gamelist linked list.

Parameters

remove

pointer to the item to be removed

Definition at line 49 of file network_gamelist.cpp.

References _network_game_list, NetworkRebuildHostList(), and UpdateNetworkGameWindow().

Referenced by NetworkGameWindow::OnKeyPress().

Variable Documentation

_network_game_list

std::vector<std::unique_ptr<NetworkGame> > _network_game_list

extern

Game list of this client.

Definition at line 18 of file network_gamelist.cpp.

Referenced by NetworkGameWindow::BuildGUINetworkGameList(), NetworkAfterNewGRFScan(), NetworkGameListAddItem(), NetworkGameListRemoveExpired(), NetworkGameListRemoveItem(), and NetworkRebuildHostList().

_network_game_list_version

int _network_game_list_version

extern

Current version of all items in the list.

Definition at line 19 of file network_gamelist.cpp.

Referenced by ClientNetworkCoordinatorSocketHandler::GetListing(), NetworkGameListAddItem(), NetworkGameListRemoveExpired(), and ClientNetworkCoordinatorSocketHandler::ReceiveGameCoordinatorListing().