gpg::ParticipantResults

#include <participant_results.h>

Uma estrutura com dados sobre os resultados por participante de uma TurnBasedMatch.

Resumo

Construtores e destrutores
ParticipantResults()
ParticipantResults(std::shared_ptr< const ParticipantResultsImpl > impl)
Cria um objeto ParticipantResults de um shared_ptr para um ParticipantResultsImpl.
ParticipantResults(const ParticipantResults & copy_from)
Cria uma cópia de um objeto ParticipantResults existente.
ParticipantResults(ParticipantResults && move_from)
Move um objeto ParticipantResults já existente.

Funções públicas
HasResultsForParticipant(const std::string & participant_id) const
bool
Retorna verdadeiro se esse objeto ParticipantResults tiver um resultado para o MultiplayerParticipant especificado.
MatchResultForParticipant(const std::string & participant_id) const
Retorna o MatchResult do participante especificado em uma TurnBasedMatch.
PlaceForParticipant(const std::string & participant_id) const
uint32_t
Retorna a posição do participante especificado em um TurnBasedMatch.
Valid() const
bool
Retorna verdadeiro se esse objeto ParticipantResults for preenchido com dados.
WithResult(const std::string & participant_id, uint32_t placing, MatchResult result) const
Cria um novo ParticipantResults que contém todos os resultados existentes e os outros dados de resultado transmitidos para essa função.
operator=(const ParticipantResults & copy_from)
Atribui esse objeto ParticipantResults de outro.
operator=(ParticipantResults && move_from)
Atribui este objeto ParticipantResults movendo outro para dentro dele.

Funções públicas

HasResultsForParticipant

bool HasResultsForParticipant(
  const std::string & participant_id
) const

Retorna verdadeiro se esse objeto ParticipantResults tiver um resultado para o MultiplayerParticipant especificado.

Valid precisa retornar true para que essa função seja utilizável.

MatchResultForParticipant

MatchResult MatchResultForParticipant(
  const std::string & participant_id
) const

Retorna o MatchResult do participante especificado em uma TurnBasedMatch.

Nem todos os participantes podem ter um MatchResult. Se HasResultsForParticipant não retornar "true", essa função retornará MatchResult::NONE. Valid precisa retornar true para que essa função seja utilizável.

ParticipantResults

 ParticipantResults()

ParticipantResults

 ParticipantResults(
  std::shared_ptr< const ParticipantResultsImpl > impl
)

Cria um objeto ParticipantResults de um shared_ptr para um ParticipantResultsImpl.

Destinado ao uso interno da API.

ParticipantResults

 ParticipantResults(
  const ParticipantResults & copy_from
)

Cria uma cópia de um objeto ParticipantResults existente.

ParticipantResults

 ParticipantResults(
  ParticipantResults && move_from
)

Move um objeto ParticipantResults já existente.

PlaceForParticipant

uint32_t PlaceForParticipant(
  const std::string & participant_id
) const

Retorna a posição do participante especificado em um TurnBasedMatch.

Observe que nem todos os participantes podem ter resultados. Se HasResultsForParticipant não retornar "true", essa função retornará 0 para um jogador que ainda não está classificado. Valid precisa retornar true para que essa função seja utilizável.

Válida

bool Valid() const

Retorna verdadeiro se esse objeto ParticipantResults for preenchido com dados.

Precisa ser verdadeiro para que as funções getter (PlaceForParticipant, MatchResultForParticipant etc.) nesse objeto ParticipantResults possam ser usadas.

WithResult

ParticipantResults WithResult(
  const std::string & participant_id,
  uint32_t placing,
  MatchResult result
) const

Cria um novo ParticipantResults que contém todos os resultados existentes e os outros dados de resultado transmitidos para essa função.

Só é possível definir um resultado uma vez por participante. A tentativa de definir mais de um resultado vai registrar um erro e não modificar o ParticipantResults. Valid precisa retornar true para que essa função seja utilizável.

Detalhes
Parâmetros
participant_id
O MultiplayerParticipant em que um resultado será adicionado.
placing
A posição do participante na partida.
result
O MatchResult do participante na partida.

operador=

ParticipantResults & operator=(
  const ParticipantResults & copy_from
)

Atribui esse objeto ParticipantResults de outro.

operador=

ParticipantResults & operator=(
  ParticipantResults && move_from
)

Atribui este objeto ParticipantResults movendo outro para dentro dele.