CMsgOsRequestDelta : public CMsgOs

This is a match request, challenging someone to a game. This message is sent both when a new challenge is issued and when an old challenge is cancelled. Challenges are normally directed at a specific player but can also be generic.

Challenges are withdrawn if the are accepted, declined, or one of the players leaves GGS.

Variables

boolfPlustrue if a new match request is being issued, false if an old match request is being withdrawn
stringidr/os id of the request
COsRequestrequestThe request data

Functions

boolIAmChallenged()returns true if I am the specific target of the challenge
boolIAmChallenging()returns true if I have issued the challenge
boolRequireAnti()Require the game be anti, or not anti (see below)
boolRequireBoardSize()Require a board size (see below)
boolRequireEqualClocks()Require both players have the same time control (see below)
boolRequireKomi()Require the game be komi, or not komi (see below)
boolRequireMaxOpponentClock()Require a maximum for the challenger's time (see below)
boolRequireMinMyClock()Require a minimum for the challenged player's time control (see below)
boolRequireRand()Require the game be rand, or not rand (see below)
boolRequireRated()Require the game be rated, or not rated (see below)
boolRequireSynch()Require the game be synch, or not synch (see below)

The Require functions all return true if the request fits the requirements, or false otherwise. If false, they also send a descriptive message to the challenger telling him why the request was declined.

For example, an "anti" game is one in which the winner is the player with the fewest discs. RequireAnti(true) requires that the game be anti . RequireAnti(false) requires that the game not be anti.

See Also

HandleOsRequestDelta