Player.hh

/** @file Player.hh
    @brief Especificaciones de Player
*/

#ifndef AKIRA_PLAYER_HH
#define AKIRA_PLAYER_HH

#ifndef NO_DIAGRAM
#include <iostream>
#endif

/** @class Player
    @brief Representa un jugador de tennis.

    Es la unidad más básica del circuito de tennis. Contiene el nombre del jugador y las estadísticas de éste.
*/
class Player
{
private:
    /** @brief Nombre del jugador. */
    std::string name;
    /** @brief Posición del jugador en el ranking global. */
    int rank_pos = 0;
    /** @brief Total de puntos del jugador en el ranking global. */
    int total_points = 0;

    // estadísticas jugador
    /** @brief Número de torneos jugados. */
    int played_tours = 0;
    /** @brief Par de enteros que representa los partidos ganados (first) y perdidos (second) del jugador. */
    std::pair <int, int> matches_won_lost = {0, 0};
    /** @brief Par de enteros que representa los sets ganados (first) y perdidos (second) del jugador. */
    std::pair <int, int> sets_won_lost = {0, 0};
    /** @brief Par de enteros que representa los juegos ganados (first) y perdidos (second) del jugador. */
    std::pair <int, int> games_won_lost = {0, 0};
    
public:
  /** @brief Creadora por defecto. 

      Se ejecuta automáticamente al declarar un jugador.
      \pre La posición del ranking debe estar entre 1 y el número de jugadores totales del circuito.
      \post El resultado es un jugador con 0 puntos iniciales y todas las estadísticas a 0, junto con su correspondiente nombre y posición del ranking.
  */  
    Player(const std::string name, int rank_pos);


  /** @brief Modificadora de posición en el rango global. 

      \pre La posición del ranking debe estar entre 1 y el número de jugadores totales del circuito.
      \post El resultado es el jugador con la nueva posición asignada.
  */  
    void modify_rank_position(int rank_pos);

  /** @brief Modificadora de puntos totales del jugador. 

      \pre El entero points tiene que ser más grande o igual a -total_points.
      \post El resultado es el jugador con los nuevos puntos sumados.
  */  
    void modify_total_points(int points);

  /** @brief Modificadora de las estadísticas del jugador.
   *  Cada parámetro corresponde a una estadísticas, la lista de correspondencias es la siguiente:
   *    points -> puntos totales jugador, wm -> partidos ganados, lm -> partidos perdidos, 
   *    ws -> sets ganados, ls -> sets perdidos, wg -> juegos ganados, lg -> juegos perdidos

      \pre Todos los enteros deben ser positivos.
      \post El resultado es el jugador con las estadísticas introducidas sumadas a las actuales.
  */  
    void modify_stats(int points, int wm, int lm, int ws, int ls, int wg, int lg);


  /** @brief Modificadora de torneos ganados del jugador.

      \pre <em>cierto<em>
      \post El número de torneos jugados habrá aumentado en una unidad.
  */  
    void increase_tour();


  /** @brief Operación de consulta de posición. 

      \pre <em>cierto</em>
      \post Retorna la posición del jugador en el ranking global.
  */  
    int get_rank_position() const;

  /** @brief Operación de consulta de nombre.

      \pre <em>cierto</em>
      \post Retorna el nombre del jugador.
  */  
    std::string get_name() const;

  /** @brief Operación de consulta de los puntos totales. 

      \pre <em>cierto</em>
      \post Retorna los puntos totales del jugador.
  */  
    int get_total_points() const;

  /** @brief Imprime el nombre, la posición en el ranking, los puntos y el resto de estadísticas.

      \pre <em>cierto</em>
      \post Las estadísticas se habrán imprimido por pantalla.
  */  
    void print_player() const;
};

#endif