report.c File Reference

#include <stdio.h>
#include <string.h>
#include "bitvector.h"
#include "fciconv.h"
#include "fcintl.h"
#include "log.h"
#include "mem.h"
#include "rand.h"
#include "support.h"
#include "achievements.h"
#include "calendar.h"
#include "connection.h"
#include "culture.h"
#include "events.h"
#include "game.h"
#include "government.h"
#include "nation.h"
#include "packets.h"
#include "player.h"
#include "research.h"
#include "specialist.h"
#include "unitlist.h"
#include "version.h"
#include "citytools.h"
#include "plrhand.h"
#include "score.h"
#include "srv_main.h"
#include "report.h"

Go to the source code of this file.

Data Structures
struct	plrdata_slot
struct	logging_civ_score
struct	player_score_entry
struct	city_score_entry
struct	dem_row
struct	dem_col

Macros
#define	HISTORIAN_FIRST   HISTORIAN_RICHEST
#define	HISTORIAN_LAST   HISTORIAN_CULTURAL
#define	MAX_SCORELOG_LINE_LEN   (119 + 1)
#define	GOOD_PLAYER(p)   ((p)->is_alive && !is_barbarian(p))

Enumerations
enum	historian_type {   HISTORIAN_RICHEST = 0 , HISTORIAN_ADVANCED = 1 , HISTORIAN_MILITARY = 2 , HISTORIAN_HAPPIEST = 3 ,   HISTORIAN_LARGEST = 4 , HISTORIAN_CULTURAL = 5 }
enum	dem_flag { DEM_COL_QUANTITY , DEM_COL_RANK , DEM_COL_BEST , DEM_COL_LAST }

Functions
static void	plrdata_slot_init (struct plrdata_slot *plrdata, const char *name)
static void	plrdata_slot_replace (struct plrdata_slot *plrdata, const char *name)
static void	plrdata_slot_free (struct plrdata_slot *plrdata)
static void	page_conn_etype (struct conn_list *dest, const char *caption, const char *headline, const char *lines, enum event_type event)
static void	page_conn (struct conn_list *dest, const char *caption, const char *headline, const char *lines)
static int	get_population (const struct player *pplayer)
static int	get_landarea (const struct player *pplayer)
static int	get_settledarea (const struct player *pplayer)
static int	get_research (const struct player *pplayer)
static int	get_production (const struct player *pplayer)
static int	get_economics (const struct player *pplayer)
static int	get_pollution (const struct player *pplayer)
static int	get_mil_service (const struct player *pplayer)
static int	get_culture (const struct player *pplayer)
static int	get_pop (const struct player *pplayer)
static int	get_cities (const struct player *pplayer)
static int	get_techs (const struct player *pplayer)
static int	get_munits (const struct player *pplayer)
static int	get_settlers (const struct player *pplayer)
static int	get_wonders (const struct player *pplayer)
static int	get_techout (const struct player *pplayer)
static int	get_literacy2 (const struct player *pplayer)
static int	get_spaceship (const struct player *pplayer)
static int	get_gold (const struct player *pplayer)
static int	get_taxrate (const struct player *pplayer)
static int	get_scirate (const struct player *pplayer)
static int	get_luxrate (const struct player *pplayer)
static int	get_riots (const struct player *pplayer)
static int	get_happypop (const struct player *pplayer)
static int	get_contentpop (const struct player *pplayer)
static int	get_unhappypop (const struct player *pplayer)
static int	get_specialists (const struct player *pplayer)
static int	get_gov (const struct player *pplayer)
static int	get_corruption (const struct player *pplayer)
static int	get_total_score (const struct player *pplayer)
static int	get_units_built (const struct player *pplayer)
static int	get_units_killed (const struct player *pplayer)
static int	get_units_lost (const struct player *pplayer)
static int	get_units_used (const struct player *pplayer)
static const char *	area_to_text (int value)
static const char *	percent_to_text (int value)
static const char *	production_to_text (int value)
static const char *	economics_to_text (int value)
static const char *	science_to_text (int value)
static const char *	mil_service_to_text (int value)
static const char *	pollution_to_text (int value)
static const char *	culture_to_text (int value)
	BV_DEFINE (bv_cols, DEM_COL_LAST)
static int	secompare (const void *a, const void *b)
static void	historian_generic (struct history_report *report, enum historian_type which_news)
void	send_current_history_report (struct conn_list *dest)
static int	nr_wonders (struct city *pcity)
void	report_top_cities (struct conn_list *dest)
void	report_wonders_of_the_world_long (struct conn_list *dest)
void	report_wonders_of_the_world (struct conn_list *dest)
static int	get_real_pop (const struct player *pplayer)
static const char *	value_units (int val, const char *uni)
static void	dem_line_item (char *outptr, size_t out_size, struct player *pplayer, struct dem_row *prow, bv_cols selcols)
bool	is_valid_demography (const char *demography, int *error)
void	report_demographics (struct connection *pconn)
void	report_achievements (struct connection *pconn)
static bool	scan_score_log (char *id)
void	log_civ_score_init (void)
void	log_civ_score_free (void)
void	log_civ_score_now (void)
void	make_history_report (void)
void	report_final_scores (struct conn_list *dest)
struct history_report *	history_report_get (void)
int	get_tag_score (const char *tag, const struct player *pplayer)

Variables
struct history_report	latest_history_report = { -2 }
static struct logging_civ_score *	score_log = nullptr
static const char *	historian_message []
static const char *	historian_name []
static const char	scorelog_magic [] = "#FREECIV SCORELOG2 "
struct {
char *   name
int(*   get_value )(const struct player *)
}	score_tags []
static struct dem_row	rowtable []
static struct dem_col	coltable [] = {{'q'}, {'r'}, {'b'}}
static const char *	ranking []

Macro Definition Documentation

GOOD_PLAYER

#define GOOD_PLAYER

(

p

)

((p)->is_alive && !is_barbarian(p))

Definition at line 234 of file report.c.

HISTORIAN_FIRST

#define HISTORIAN_FIRST   HISTORIAN_RICHEST

Definition at line 92 of file report.c.

HISTORIAN_LAST

#define HISTORIAN_LAST   HISTORIAN_CULTURAL

Definition at line 93 of file report.c.

MAX_SCORELOG_LINE_LEN

#define MAX_SCORELOG_LINE_LEN   (119 + 1)

Definition at line 130 of file report.c.

Enumeration Type Documentation

dem_flag

enum dem_flag

Enumerator
DEM_COL_QUANTITY
DEM_COL_RANK
DEM_COL_BEST
DEM_COL_LAST

Definition at line 260 of file report.c.

historian_type

enum historian_type

Enumerator
HISTORIAN_RICHEST
HISTORIAN_ADVANCED
HISTORIAN_MILITARY
HISTORIAN_HAPPIEST
HISTORIAN_LARGEST
HISTORIAN_CULTURAL

Definition at line 84 of file report.c.

Function Documentation

area_to_text()

static const char * area_to_text ( int  value )

static

Helper functions which transform the given value to a string depending on the unit.

Definition at line 1017 of file report.c.

BV_DEFINE()

BV_DEFINE	(	bv_cols	,
		DEM_COL_LAST
	)

culture_to_text()

static const char * culture_to_text ( int  value )

static

Construct string containing value followed by unit suitable for culture stats.

Definition at line 1085 of file report.c.

dem_line_item()

static void dem_line_item ( char *  outptr, size_t  out_size, struct player *  pplayer, struct dem_row *  prow, bv_cols  selcols  )

static

Construct one demographics line.

Definition at line 1094 of file report.c.

Referenced by report_demographics().

economics_to_text()

static const char * economics_to_text ( int  value )

static

Construct string containing value followed by unit suitable for economics stats.

Definition at line 1048 of file report.c.

get_cities()

static int get_cities ( const struct player *  pplayer )

static

Number of cities

Definition at line 761 of file report.c.

Referenced by report_final_scores().

get_contentpop()

static int get_contentpop ( const struct player *  pplayer )

static

Number of content citizens

Definition at line 934 of file report.c.

get_corruption()

static int get_corruption ( const struct player *  pplayer )

static

Total corruption

Definition at line 972 of file report.c.

get_culture()

static int get_culture ( const struct player *  pplayer )

static

Culture score

Definition at line 994 of file report.c.

Referenced by report_final_scores().

get_economics()

static int get_economics ( const struct player *  pplayer )

static

BNP of player

Definition at line 737 of file report.c.

Referenced by report_final_scores().

get_gold()

static int get_gold ( const struct player *  pplayer )

static

Amount of gold.

Definition at line 878 of file report.c.

get_gov()

static int get_gov ( const struct player *  pplayer )

static

Current government

Definition at line 964 of file report.c.

get_happypop()

static int get_happypop ( const struct player *  pplayer )

static

Number of happy citizens

Definition at line 926 of file report.c.

get_landarea()

static int get_landarea ( const struct player *  pplayer )

static

Land area controlled by player

Definition at line 705 of file report.c.

Referenced by report_final_scores().

get_literacy2()

static int get_literacy2 ( const struct player *  pplayer )

static

Literacy score calculated one way. See also get_literacy() to see alternative way.

Definition at line 830 of file report.c.

get_luxrate()

static int get_luxrate ( const struct player *  pplayer )

static

Luxury rate

Definition at line 902 of file report.c.

get_mil_service()

static int get_mil_service ( const struct player *  pplayer )

static

Military service length

Definition at line 753 of file report.c.

Referenced by report_final_scores().

get_munits()

static int get_munits ( const struct player *  pplayer )

static

Number of military units

Definition at line 777 of file report.c.

get_pollution()

static int get_pollution ( const struct player *  pplayer )

static

Pollution of player

Definition at line 745 of file report.c.

get_pop()

static int get_pop ( const struct player *  pplayer )

static

Number of citizen units of player

Definition at line 689 of file report.c.

Referenced by get_real_pop().

get_population()

static int get_population ( const struct player *  pplayer )

static

Population of player

Definition at line 681 of file report.c.

get_production()

static int get_production ( const struct player *  pplayer )

static

Production of player

Definition at line 729 of file report.c.

Referenced by report_final_scores().

get_real_pop()

static int get_real_pop ( const struct player *  pplayer )

static

Number of citizens of player

Definition at line 697 of file report.c.

Referenced by report_final_scores().

get_research()

static int get_research ( const struct player *  pplayer )

static

Research speed

Definition at line 721 of file report.c.

Referenced by report_final_scores().

get_riots()

static int get_riots ( const struct player *  pplayer )

static

Number of rioting cities

Definition at line 910 of file report.c.

get_scirate()

static int get_scirate ( const struct player *  pplayer )

static

Science rate

Definition at line 894 of file report.c.

get_settledarea()

static int get_settledarea ( const struct player *  pplayer )

static

Area settled.

Definition at line 713 of file report.c.

Referenced by report_final_scores().

get_settlers()

static int get_settlers ( const struct player *  pplayer )

static

Number of city building units.

Definition at line 794 of file report.c.

get_spaceship()

static int get_spaceship ( const struct player *  pplayer )

static

Spaceship score

Definition at line 838 of file report.c.

Referenced by report_final_scores().

get_specialists()

static int get_specialists ( const struct player *  pplayer )

static

Number of specialists.

Definition at line 950 of file report.c.

get_tag_score()

int get_tag_score	(	const char *	tag,
		const struct player *	pplayer
	)

Return score of the type associated to the tag

Definition at line 1867 of file report.c.

Referenced by api_methods_tag_score().

get_taxrate()

static int get_taxrate ( const struct player *  pplayer )

static

Tax rate

Definition at line 886 of file report.c.

get_techout()

static int get_techout ( const struct player *  pplayer )

static

Technology output

Definition at line 821 of file report.c.

get_techs()

static int get_techs ( const struct player *  pplayer )

static

Number of techs

Definition at line 769 of file report.c.

Referenced by report_final_scores().

get_total_score()

static int get_total_score ( const struct player *  pplayer )

static

Total score

Definition at line 986 of file report.c.

get_unhappypop()

static int get_unhappypop ( const struct player *  pplayer )

static

Number of unhappy citizens

Definition at line 942 of file report.c.

get_units_built()

static int get_units_built ( const struct player *  pplayer )

static

Number of units built

Definition at line 846 of file report.c.

Referenced by report_final_scores().

get_units_killed()

static int get_units_killed ( const struct player *  pplayer )

static

Number of units killed

Definition at line 854 of file report.c.

Referenced by report_final_scores().

get_units_lost()

static int get_units_lost ( const struct player *  pplayer )

static

Number of units lost

Definition at line 862 of file report.c.

Referenced by report_final_scores().

get_units_used()

static int get_units_used ( const struct player *  pplayer )

static

Number of units used

Definition at line 870 of file report.c.

Referenced by report_final_scores().

get_wonders()

static int get_wonders ( const struct player *  pplayer )

static

Wonder score

Definition at line 813 of file report.c.

Referenced by report_final_scores().

historian_generic()

static void historian_generic ( struct history_report *  report, enum historian_type  which_news  )

static

Construct Historian Report

Definition at line 317 of file report.c.

Referenced by make_history_report().

history_report_get()

struct history_report * history_report_get

(

void

)

Return current history report

Definition at line 1859 of file report.c.

Referenced by sg_load_history(), sg_load_history(), and sg_save_history().

is_valid_demography()

bool is_valid_demography	(	const char *	demography,
		int *	error
	)

Verify that a given demography string is valid. See game.demography. If the string is not valid the index of the first invalid character is return as 'error'.

Other settings callback functions are in settings.c, but this one uses static values from this file so it's done separately.

Definition at line 1158 of file report.c.

Referenced by demography_callback().

log_civ_score_free()

void log_civ_score_free

(

void

)

Free resources allocated for score logging system

Definition at line 1514 of file report.c.

Referenced by log_civ_score_now(), scorelog_action(), and server_game_free().

log_civ_score_init()

void log_civ_score_init

(

void

)

Initialize score logging system

Definition at line 1491 of file report.c.

Referenced by scorelog_action().

log_civ_score_now()

void log_civ_score_now

(

void

)

Create a log file of the civilizations so you can see what was happening.

Definition at line 1544 of file report.c.

Referenced by begin_turn(), and srv_scores().

make_history_report()

void make_history_report

(

void

)

Produce random history report if it's time for one.

Definition at line 1702 of file report.c.

Referenced by end_turn().

mil_service_to_text()

static const char * mil_service_to_text ( int  value )

static

Construct string containing value followed by unit suitable for military service stats.

Definition at line 1067 of file report.c.

nr_wonders()

static int nr_wonders ( struct city *  pcity )

static

Returns the number of wonders the given city has.

Definition at line 394 of file report.c.

Referenced by report_top_cities().

page_conn()

static void page_conn ( struct conn_list *  dest, const char *  caption, const char *  headline, const char *  lines  )

static

This function pops up a non-modal message dialog on the player's desktop

Definition at line 1804 of file report.c.

Referenced by report_achievements(), report_demographics(), report_top_cities(), report_wonders_of_the_world(), and report_wonders_of_the_world_long().

page_conn_etype()

static void page_conn_etype ( struct conn_list *  dest, const char *  caption, const char *  headline, const char *  lines, enum event_type  event  )

static

This function pops up a non-modal message dialog on the player's desktop

event == E_REPORT: message should not be ignored by clients watching AI players with ai_popup_windows off. Example: Server Options, Demographics Report, etc.

event == E_BROADCAST_REPORT: message can safely be ignored by clients watching AI players with ai_popup_windows off. For example: Herodot's report... and similar messages.

Definition at line 1821 of file report.c.

Referenced by page_conn(), and send_current_history_report().

percent_to_text()

static const char * percent_to_text ( int  value )

static

Construct string containing value followed by ''. So value is already considered to be in units of 1/100.

Definition at line 1027 of file report.c.

plrdata_slot_free()

static void plrdata_slot_free ( struct plrdata_slot *  plrdata )

static

Free resources allocated for plrdata slot.

Definition at line 1322 of file report.c.

Referenced by log_civ_score_now(), and scan_score_log().

plrdata_slot_init()

static void plrdata_slot_init ( struct plrdata_slot *  plrdata, const char *  name  )

static

Allocate and initialize plrdata slot.

Definition at line 1299 of file report.c.

Referenced by log_civ_score_now(), and scan_score_log().

plrdata_slot_replace()

static void plrdata_slot_replace ( struct plrdata_slot *  plrdata, const char *  name  )

static

Replace plrdata slot with new one named according to input parameter.

Definition at line 1311 of file report.c.

Referenced by log_civ_score_now(), and plrdata_slot_init().

pollution_to_text()

static const char * pollution_to_text ( int  value )

static

Construct string containing value followed by unit suitable for pollution stats.

Definition at line 1076 of file report.c.

production_to_text()

static const char * production_to_text ( int  value )

static

Construct string containing value followed by unit suitable for production stats.

Definition at line 1036 of file report.c.

report_achievements()

void report_achievements

(

struct connection *

pconn

)

Send achievements list

Definition at line 1269 of file report.c.

Referenced by handle_report_req().

report_demographics()

void report_demographics

(

struct connection *

pconn

)

Send demographics report; what gets reported depends on value of demographics server option.

Definition at line 1205 of file report.c.

Referenced by handle_report_req().

report_final_scores()

void report_final_scores

(

struct conn_list *

dest

)

Inform clients about player scores and statistics when the game ends. Called only from server/srv_main.c srv_scores()

Definition at line 1724 of file report.c.

Referenced by connection_attach_real(), and srv_scores().

report_top_cities()

void report_top_cities

(

struct conn_list *

dest

)

Send report listing the "best" cities in the world.

Definition at line 410 of file report.c.

Referenced by handle_report_req().

report_wonders_of_the_world()

void report_wonders_of_the_world

(

struct conn_list *

dest

)

Send report listing all built and destroyed wonders, and wonders currently being built.

Definition at line 604 of file report.c.

Referenced by handle_report_req().

report_wonders_of_the_world_long()

void report_wonders_of_the_world_long

(

struct conn_list *

dest

)

Send report listing all built and destroyed wonders, and wonders currently being built.

Definition at line 493 of file report.c.

Referenced by handle_report_req().

scan_score_log()

static bool scan_score_log ( char *  id )

static

Reads the whole file denoted by fp. Sets last_turn and id to the values contained in the file. Returns the player_names indexed by player_no at the end of the log file.

Returns TRUE iff the file had read successfully.

Definition at line 1337 of file report.c.

Referenced by log_civ_score_now().

science_to_text()

static const char * science_to_text ( int  value )

static

Construct string containing value followed by unit suitable for science stats.

Definition at line 1058 of file report.c.

secompare()

static int secompare ( const void *  a, const void *  b  )

static

Compare two player score entries. Used as callback for qsort.

Definition at line 308 of file report.c.

Referenced by historian_generic(), report_final_scores(), and report_top_cities().

send_current_history_report()

void send_current_history_report

(

struct conn_list *

dest

)

Send history report of this turn.

Definition at line 381 of file report.c.

Referenced by establish_new_connection(), and make_history_report().

value_units()

static const char * value_units ( int  val, const char *  uni  )

static

Construct string containing value and its unit.

Definition at line 1002 of file report.c.

Referenced by area_to_text(), culture_to_text(), economics_to_text(), mil_service_to_text(), percent_to_text(), pollution_to_text(), production_to_text(), and science_to_text().

Variable Documentation

coltable

struct dem_col coltable[] = {{'q'}, {'r'}, {'b'}}

static

Referenced by is_valid_demography(), and report_demographics().

get_value

int(* get_value) (const struct player *)

(

const struct player *

)

Definition at line 193 of file report.c.

Referenced by log_civ_score_now().

historian_message

const char* historian_message[]

static

Initial value:

= {
    
    N_("%s %s reports on the RICHEST Civilizations in the World."),
    
    N_("%s %s reports on the most ADVANCED Civilizations in the World."),
    
    N_("%s %s reports on the most MILITARIZED Civilizations in the World."),
    
    N_("%s %s reports on the HAPPIEST Civilizations in the World."),
    
    N_("%s %s reports on the LARGEST Civilizations in the World."),
    
 
}

Definition at line 95 of file report.c.

Referenced by historian_generic().

historian_name

const char* historian_name[]

static

Initial value:

= {
    
    N_("Herodotus"),
    
    N_("Thucydides"),
    
    N_("Pliny the Elder"),
    
    N_("Livy"),
    
    N_("Toynbee"),
    
    N_("Gibbon"),
    
    N_("Ssu-ma Ch'ien"),
    
 
}

Definition at line 110 of file report.c.

Referenced by historian_generic().

latest_history_report

struct history_report latest_history_report = { -2 }

Definition at line 68 of file report.c.

Referenced by history_report_get(), log_civ_score_init(), make_history_report(), and send_current_history_report().

name

char* name

Definition at line 192 of file report.c.

Referenced by get_tag_score(), plrdata_slot_init(), plrdata_slot_replace(), and report_demographics().

ranking

const char* ranking[]

static

Definition at line 272 of file report.c.

Referenced by historian_generic().

rowtable

struct dem_row rowtable[]

static

Initial value:

= {
  {'N', N_("Population"),       get_population,  population_to_text,  TRUE },
  {'A', N_("Land Area"),        get_landarea,    area_to_text,        TRUE },
  {'S', N_("Settled Area"),     get_settledarea, area_to_text,        TRUE },
  {'R', N_("Research Speed"),   get_research,    science_to_text,     TRUE },
  
  {'L', N_("?ability:Literacy"), get_literacy,    percent_to_text,     TRUE },
  {'P', N_("Production"),       get_production,  production_to_text,  TRUE },
  {'E', N_("Economics"),        get_economics,   economics_to_text,   TRUE },
  {'M', N_("Military Service"), get_mil_service, mil_service_to_text, FALSE },
  {'O', N_("?stats:Pollution"), get_pollution,   pollution_to_text,   FALSE },
  {'C', N_("Culture"),          get_culture,     culture_to_text,     TRUE }
}

Referenced by is_valid_demography(), and report_demographics().

score_log

struct logging_civ_score* score_log = nullptr

static

Definition at line 70 of file report.c.

Referenced by log_civ_score_free(), log_civ_score_init(), log_civ_score_now(), and scan_score_log().

[struct]

const struct { ... } score_tags[]

Referenced by get_tag_score(), and log_civ_score_now().

scorelog_magic

const char scorelog_magic[] = "#FREECIV SCORELOG2 "

static

Definition at line 132 of file report.c.

Referenced by log_civ_score_now(), and scan_score_log().