Freeciv-3.2
Loading...
Searching...
No Matches
Data Structures | Macros | Functions | Variables
nation.c File Reference
#include "fcintl.h"
#include "log.h"
#include "mem.h"
#include "support.h"
#include "connection.h"
#include "game.h"
#include "government.h"
#include "player.h"
#include "rgbcolor.h"
#include "tech.h"
#include "traits.h"
#include "nation.h"

Go to the source code of this file.

Data Structures

struct  nation_set
 
struct  nation_leader
 
struct  nation_city
 
struct  nation_iter
 
struct  nation_set_iter
 
struct  nation_group_iter
 

Macros

#define NATION_CHECK(pnation, action)   /* Do Nothing. */
 
#define NATION_ITER(p)   ((struct nation_iter *)(p))
 
#define NATION_SET_ITER(p)   ((struct nation_set_iter *)(p))
 
#define NATION_GROUP_ITER(p)   ((struct nation_group_iter *)(p))
 

Functions

struct nation_typenation_by_translated_plural (const char *name)
 
struct nation_typenation_by_rule_name (const char *name)
 
const charnation_rule_name (const struct nation_type *pnation)
 
const charnation_adjective_translation (const struct nation_type *pnation)
 
const charnation_plural_translation (const struct nation_type *pnation)
 
const charnation_adjective_for_player (const struct player *pplayer)
 
const charnation_plural_for_player (const struct player *pplayer)
 
bool is_nation_pickable (const struct nation_type *nation)
 
bool is_nation_playable (const struct nation_type *nation)
 
enum barbarian_type nation_barbarian_type (const struct nation_type *nation)
 
const struct nation_leader_listnation_leaders (const struct nation_type *pnation)
 
struct nation_leadernation_leader_new (struct nation_type *pnation, const char *name, bool is_male)
 
static void nation_leader_destroy (struct nation_leader *pleader)
 
struct nation_leadernation_leader_by_name (const struct nation_type *pnation, const char *name)
 
const charnation_leader_name (const struct nation_leader *pleader)
 
bool nation_leader_is_male (const struct nation_leader *pleader)
 
const charnation_legend_translation (const struct nation_type *pnation, const char *legend)
 
const struct nation_city_listnation_cities (const struct nation_type *pnation)
 
struct nation_citynation_city_new (struct nation_type *pnation, const char *name)
 
static void nation_city_destroy (struct nation_city *pncity)
 
enum nation_city_preference nation_city_preference_revert (enum nation_city_preference prefer)
 
void nation_city_set_terrain_preference (struct nation_city *pncity, const struct terrain *pterrain, enum nation_city_preference prefer)
 
void nation_city_set_river_preference (struct nation_city *pncity, enum nation_city_preference prefer)
 
const charnation_city_name (const struct nation_city *pncity)
 
enum nation_city_preference nation_city_terrain_preference (const struct nation_city *pncity, const struct terrain *pterrain)
 
enum nation_city_preference nation_city_river_preference (const struct nation_city *pncity)
 
struct nation_typenation_of_player (const struct player *pplayer)
 
struct nation_typenation_of_city (const struct city *pcity)
 
struct nation_typenation_of_unit (const struct unit *punit)
 
struct nation_typenation_by_number (const Nation_type_id nation)
 
Nation_type_id nation_number (const struct nation_type *pnation)
 
Nation_type_id nation_index (const struct nation_type *pnation)
 
Nation_type_id nation_count (void)
 
size_t nation_iter_sizeof (void)
 
static void nation_iter_next (struct iterator *iter)
 
static voidnation_iter_get (const struct iterator *iter)
 
static bool nation_iter_valid (const struct iterator *iter)
 
struct iteratornation_iter_init (struct nation_iter *it)
 
static void nation_init (struct nation_type *pnation)
 
static void nation_free (struct nation_type *pnation)
 
void nations_alloc (int num)
 
void nations_free (void)
 
struct governmentinit_government_of_nation (const struct nation_type *pnation)
 
struct nation_stylestyle_of_nation (const struct nation_type *pnation)
 
const struct rgbcolornation_color (const struct nation_type *pnation)
 
int nation_set_count (void)
 
int nation_set_index (const struct nation_set *pset)
 
int nation_set_number (const struct nation_set *pset)
 
struct nation_setnation_set_new (const char *set_name, const char *set_rule_name, const char *set_description)
 
struct nation_setnation_set_by_number (int id)
 
struct nation_setnation_set_by_rule_name (const char *name)
 
const charnation_set_untranslated_name (const struct nation_set *pset)
 
const charnation_set_rule_name (const struct nation_set *pset)
 
const charnation_set_name_translation (const struct nation_set *pset)
 
const charnation_set_description (const struct nation_set *pset)
 
bool nation_is_in_set (const struct nation_type *pnation, const struct nation_set *pset)
 
struct nation_setnation_set_by_setting_value (const char *setting)
 
size_t nation_set_iter_sizeof (void)
 
static void nation_set_iter_next (struct iterator *iter)
 
static voidnation_set_iter_get (const struct iterator *iter)
 
static bool nation_set_iter_valid (const struct iterator *iter)
 
struct iteratornation_set_iter_init (struct nation_set_iter *it)
 
int nation_group_count (void)
 
int nation_group_index (const struct nation_group *pgroup)
 
int nation_group_number (const struct nation_group *pgroup)
 
struct nation_groupnation_group_new (const char *name)
 
struct nation_groupnation_group_by_number (int id)
 
struct nation_groupnation_group_by_rule_name (const char *name)
 
void nation_group_set_hidden (struct nation_group *pgroup, bool hidden)
 
void nation_group_set_match (struct nation_group *pgroup, int match)
 
bool is_nation_group_hidden (struct nation_group *pgroup)
 
const charnation_group_untranslated_name (const struct nation_group *pgroup)
 
const charnation_group_rule_name (const struct nation_group *pgroup)
 
const charnation_group_name_translation (const struct nation_group *pgroup)
 
bool nation_is_in_group (const struct nation_type *pnation, const struct nation_group *pgroup)
 
size_t nation_group_iter_sizeof (void)
 
static void nation_group_iter_next (struct iterator *iter)
 
static voidnation_group_iter_get (const struct iterator *iter)
 
static bool nation_group_iter_valid (const struct iterator *iter)
 
struct iteratornation_group_iter_init (struct nation_group_iter *it)
 
void nation_sets_groups_init (void)
 
void nation_sets_groups_free (void)
 
bool can_conn_edit_players_nation (const struct connection *pconn, const struct player *pplayer)
 
int nations_match (const struct nation_type *pnation1, const struct nation_type *pnation2, bool ignore_conflicts)
 

Variables

static struct nation_typenations = NULL
 
static int num_nation_sets
 
static struct nation_set nation_sets [MAX_NUM_NATION_SETS]
 
static int num_nation_groups
 
static struct nation_group nation_groups [MAX_NUM_NATION_GROUPS]
 

Macro Definition Documentation

◆ NATION_CHECK

#define NATION_CHECK (   pnation,
  action 
)    /* Do Nothing. */

Definition at line 99 of file nation.c.

◆ NATION_GROUP_ITER

#define NATION_GROUP_ITER (   p)    ((struct nation_group_iter *)(p))

Definition at line 1119 of file nation.c.

◆ NATION_ITER

#define NATION_ITER (   p)    ((struct nation_iter *)(p))

Definition at line 519 of file nation.c.

◆ NATION_SET_ITER

#define NATION_SET_ITER (   p)    ((struct nation_set_iter *)(p))

Definition at line 884 of file nation.c.

Function Documentation

◆ can_conn_edit_players_nation()

bool can_conn_edit_players_nation ( const struct connection pconn,
const struct player pplayer 
)

Return TRUE iff the editor is allowed to edit the player's nation in pregame.

Definition at line 1187 of file nation.c.

Referenced by create_conn_menu(), handle_nation_select_req(), and fc_client::start_page_menu().

◆ init_government_of_nation()

struct government * init_government_of_nation ( const struct nation_type pnation)

Returns initial government type for this nation. Always returns non-NULL – nation-specific government or failing that ruleset default government.

Definition at line 659 of file nation.c.

Referenced by create_animals(), create_barbarian_player(), create_command_newcomer(), dai_manage_government(), final_ruleset_adjustments(), handle_edit_player_create(), and split_player().

◆ is_nation_group_hidden()

bool is_nation_group_hidden ( struct nation_group pgroup)

Return whether this group should appear in the nation selection UI.

Definition at line 1057 of file nation.c.

Referenced by create_nation_selection_lists(), create_races_dialog(), and races_dialog::refresh().

◆ is_nation_pickable()

bool is_nation_pickable ( const struct nation_type nation)

Return whether a nation is "pickable" – whether players can select it at game start. (Client only function – on the server, use client_can_pick_nation().)

Definition at line 188 of file nation.c.

Referenced by create_list_of_nations_in_group(), get_playable_nation_count(), popup_races_dialog(), races_toggles_set_sensitive(), races_update_pickable(), races_dialog::refresh(), and races_dialog::set_index().

◆ is_nation_playable()

bool is_nation_playable ( const struct nation_type nation)

Return whether a nation is "playable"; i.e., whether a human player can choose this nation. Barbarian and observer nations are not playable.

This does not check whether a nation is "used" or "available".

Definition at line 200 of file nation.c.

Referenced by client_can_pick_nation(), count_playable_nations(), create_list_of_nations_in_group(), create_races_dialog(), extviewer_refresh_widgets(), generate_players(), handle_edit_player(), load_ruleset_nations(), pick_a_nation(), popup_races_dialog(), races_dialog::refresh(), races_dialog::set_index(), and show_nationsets().

◆ nation_adjective_for_player()

const char * nation_adjective_for_player ( const struct player pplayer)

Return the (translated) adjective for the given nation of a player. You don't have to free the return pointer.

Definition at line 169 of file nation.c.

Referenced by announce_trade_route_removal(), check_city_migrations_player(), check_for_game_over(), col_nation(), col_nation(), collect_ransom(), cr_entry_nation(), debug_command(), diplomat_bribe(), diplomat_get_tech(), diplomat_incite(), diplomat_infiltrate_tile(), diplomat_sabotage(), do_attack(), do_capture_units(), do_city_migration(), do_expel_unit(), do_heal_unit(), do_nuke_tile(), do_wipe_units(), endgame_report_dialog_player(), get_full_nation(), get_report_title(), get_unit_info_label_text2(), handle_diplomacy_accept_treaty_req(), kill_unit(), plr_widget::nation_selected(), notify_actor_caught(), notify_actor_success(), notify_illegal_armistice_units(), player_loot_player(), players_war_callback(), players_war_callback(), popup_action_selection(), popup_advanced_terrain_dialog(), popup_diplomacy_dialog(), popup_diplomatic_objects(), popup_goto_airlift_dialog(), popup_info_text(), popup_players_nations_dialog(), popup_spaceship_dialog(), popup_war_dialog(), real_conn_list_dialog_update(), redraw_unit_info_label(), report_achievements(), report_demographics(), report_top_cities(), report_wonders_of_the_world(), report_wonders_of_the_world_long(), score_tooltip(), show_players(), spaceship_arrived(), spaceship_lost(), spy_nuke_city(), spy_poison(), spy_sabotage_unit(), spy_spread_plague(), spy_steal_gold(), spy_steal_some_maps(), tgt_extra_descr(), transfer_unit(), unit_bombard(), unit_description(), unit_do_help_build(), unit_select_dialog_popup(), pregame_options::update_buttons(), update_diplomacy_dialog(), update_info_label(), update_intel_dialog(), update_intel_wonder_dialog(), city_dialog::update_nation_table(), and fc_client::update_start_page().

◆ nation_adjective_translation()

const char * nation_adjective_translation ( const struct nation_type pnation)

◆ nation_barbarian_type()

enum barbarian_type nation_barbarian_type ( const struct nation_type nation)

Returns which kind of barbarians can use this nation.

This does not check whether a nation is "used" or "available".

Definition at line 211 of file nation.c.

Referenced by assign_player_colors(), extviewer_refresh_widgets(), handle_edit_player(), hard_code_oblig_hard_reqs_ruleset(), load_ruleset_nations(), pick_a_nation(), sanity_check_ruleset_data(), and update_nations_with_startpos().

◆ nation_by_number()

struct nation_type * nation_by_number ( const Nation_type_id  nation)

◆ nation_by_rule_name()

struct nation_type * nation_by_rule_name ( const char name)

Returns the nation that has the given (untranslated) rule name (adjective). Returns NO_NATION_SELECTED if none match.

Definition at line 121 of file nation.c.

Referenced by api_find_nation_type_by_name(), load_ruleset_nations(), playernation_command(), sanity_check_ruleset_data(), save_nations_ruleset(), sg_load_map_startpos(), sg_load_map_startpos(), sg_load_player_main(), sg_load_player_main(), and universal_value_from_str().

◆ nation_by_translated_plural()

struct nation_type * nation_by_translated_plural ( const char name)

Returns the nation that has the given (translated) plural noun. Returns NO_NATION_SELECTED if none match.

Definition at line 106 of file nation.c.

Referenced by help_update_dialog(), help_dialog::make_tree(), and help_widget::set_topic_nation().

◆ nation_cities()

const struct nation_city_list * nation_cities ( const struct nation_type pnation)

Return the default cities of the nation (server only function).

Definition at line 331 of file nation.c.

Referenced by city_name_suggestion(), and is_default_city_name().

◆ nation_city_destroy()

static void nation_city_destroy ( struct nation_city pncity)
static

Destroy a default nation city created with nation_city_new().

Definition at line 361 of file nation.c.

Referenced by nation_init().

◆ nation_city_name()

const char * nation_city_name ( const struct nation_city pncity)

Return the name of the default nation city.

Definition at line 412 of file nation.c.

Referenced by is_default_city_name(), save_nation(), and search_for_city_name().

◆ nation_city_new()

struct nation_city * nation_city_new ( struct nation_type pnation,
const char name 
)

Create a new default city for the nation (server only function).

Definition at line 342 of file nation.c.

Referenced by load_city_name_list().

◆ nation_city_preference_revert()

enum nation_city_preference nation_city_preference_revert ( enum nation_city_preference  prefer)

Reverts the nation city preference.

Definition at line 371 of file nation.c.

Referenced by evaluate_city_name_priority().

◆ nation_city_river_preference()

enum nation_city_preference nation_city_river_preference ( const struct nation_city pncity)

Return the default nation city preference for rivers.

Definition at line 434 of file nation.c.

Referenced by evaluate_city_name_priority(), and save_nation().

◆ nation_city_set_river_preference()

void nation_city_set_river_preference ( struct nation_city pncity,
enum nation_city_preference  prefer 
)

Set the default nation city preference about rivers.

Definition at line 402 of file nation.c.

Referenced by load_city_name_list().

◆ nation_city_set_terrain_preference()

void nation_city_set_terrain_preference ( struct nation_city pncity,
const struct terrain pterrain,
enum nation_city_preference  prefer 
)

Set the default nation city preference for the terrain.

Definition at line 390 of file nation.c.

Referenced by load_city_name_list().

◆ nation_city_terrain_preference()

enum nation_city_preference nation_city_terrain_preference ( const struct nation_city pncity,
const struct terrain pterrain 
)

Return the default nation city preference for the terrain.

Definition at line 422 of file nation.c.

Referenced by evaluate_city_name_priority(), and save_nation().

◆ nation_color()

const struct rgbcolor * nation_color ( const struct nation_type pnation)

Returns nation's player color preference, or NULL if none. Server only function.

Definition at line 682 of file nation.c.

Referenced by assign_player_colors(), player_preferred_color(), and plrcol_validate().

◆ nation_count()

Nation_type_id nation_count ( void  )

◆ nation_free()

static void nation_free ( struct nation_type pnation)
static

De-allocate resources associated with the given nation.

Definition at line 599 of file nation.c.

Referenced by nations_free().

◆ nation_group_by_number()

struct nation_group * nation_group_by_number ( int  id)

Return the nation group with the given index.

This function returns NULL for an out-of-range index (some callers rely on this).

Definition at line 1004 of file nation.c.

Referenced by create_nation_selection_lists(), handle_ruleset_nation(), races_dialog::refresh(), races_dialog::set_index(), universal_by_number(), and universal_value_initial().

◆ nation_group_by_rule_name()

struct nation_group * nation_group_by_rule_name ( const char name)

Return the nation group that has the given (untranslated) rule name. Returns NULL if no group is found.

Definition at line 1021 of file nation.c.

Referenced by load_ruleset_nations(), nation_group_new(), nation_set_new(), and universal_value_from_str().

◆ nation_group_count()

int nation_group_count ( void  )

◆ nation_group_index()

int nation_group_index ( const struct nation_group pgroup)

Return the nation group index.

Definition at line 943 of file nation.c.

Referenced by handle_ruleset_nation_groups(), and nation_group_number().

◆ nation_group_iter_get()

static void * nation_group_iter_get ( const struct iterator iter)
static

Implementation of iterator 'get' function.

Definition at line 1140 of file nation.c.

Referenced by nation_group_iter_init().

◆ nation_group_iter_init()

struct iterator * nation_group_iter_init ( struct nation_group_iter it)

Implementation of iterator 'init' function.

Definition at line 1157 of file nation.c.

◆ nation_group_iter_next()

static void nation_group_iter_next ( struct iterator iter)
static

Implementation of iterator 'next' function.

Definition at line 1132 of file nation.c.

Referenced by nation_group_iter_init().

◆ nation_group_iter_sizeof()

size_t nation_group_iter_sizeof ( void  )

Implementation of iterator 'sizeof' function.

Definition at line 1124 of file nation.c.

◆ nation_group_iter_valid()

static bool nation_group_iter_valid ( const struct iterator iter)
static

Implementation of iterator 'valid' function.

Definition at line 1148 of file nation.c.

Referenced by nation_group_iter_init().

◆ nation_group_name_translation()

const char * nation_group_name_translation ( const struct nation_group pgroup)

Return the translated name of a nation group. You don't have to free the return pointer.

Definition at line 1090 of file nation.c.

Referenced by create_nation_selection_lists(), races_dialog::refresh(), req_text_insert(), universal_name_translation(), and worklist_item_postpone_req_vec().

◆ nation_group_new()

struct nation_group * nation_group_new ( const char name)

Add new group into the array of groups.

Definition at line 960 of file nation.c.

Referenced by handle_ruleset_nation_groups(), and load_nation_names().

◆ nation_group_number()

int nation_group_number ( const struct nation_group pgroup)

Return the nation group index.

Definition at line 952 of file nation.c.

Referenced by send_ruleset_nations(), and universal_number().

◆ nation_group_rule_name()

const char * nation_group_rule_name ( const struct nation_group pgroup)

Return the (untranslated) rule name of a nation group. You don't have to free the return pointer.

Definition at line 1079 of file nation.c.

Referenced by save_nation(), universal_kind_values(), and universal_rule_name().

◆ nation_group_set_hidden()

void nation_group_set_hidden ( struct nation_group pgroup,
bool  hidden 
)

Set whether this group should appear in the nation selection UI.

Definition at line 1037 of file nation.c.

Referenced by load_ruleset_nations().

◆ nation_group_set_match()

void nation_group_set_match ( struct nation_group pgroup,
int  match 
)

Set how much the AI will try to select a nation in the same group. Server only function.

Definition at line 1047 of file nation.c.

Referenced by load_ruleset_nations().

◆ nation_group_untranslated_name()

const char * nation_group_untranslated_name ( const struct nation_group pgroup)

Return the untranslated name of a nation group (including qualifier, if any). You usually want nation_group_rule_name() instead. You don't have to free the return pointer.

Definition at line 1069 of file nation.c.

Referenced by send_ruleset_nations().

◆ nation_index()

Nation_type_id nation_index ( const struct nation_type pnation)

◆ nation_init()

static void nation_init ( struct nation_type pnation)
static

Allocate resources associated with the given nation.

Definition at line 574 of file nation.c.

Referenced by nations_alloc().

◆ nation_is_in_group()

bool nation_is_in_group ( const struct nation_type pnation,
const struct nation_group pgroup 
)

◆ nation_is_in_set()

bool nation_is_in_set ( const struct nation_type pnation,
const struct nation_set pset 
)

◆ nation_iter_get()

static void * nation_iter_get ( const struct iterator iter)
static

Implementation of iterator 'get' function.

Definition at line 540 of file nation.c.

Referenced by nation_iter_init().

◆ nation_iter_init()

struct iterator * nation_iter_init ( struct nation_iter it)

Implementation of iterator 'init' function.

Definition at line 557 of file nation.c.

Referenced by startpos_iter_init().

◆ nation_iter_next()

static void nation_iter_next ( struct iterator iter)
static

Implementation of iterator 'next' function.

Definition at line 532 of file nation.c.

Referenced by nation_iter_init().

◆ nation_iter_sizeof()

size_t nation_iter_sizeof ( void  )

Implementation of iterator 'sizeof' function.

Definition at line 524 of file nation.c.

Referenced by startpos_iter_sizeof().

◆ nation_iter_valid()

static bool nation_iter_valid ( const struct iterator iter)
static

Implementation of iterator 'valid' function.

Definition at line 548 of file nation.c.

Referenced by nation_iter_init().

◆ nation_leader_by_name()

struct nation_leader * nation_leader_by_name ( const struct nation_type pnation,
const char name 
)

Returns the nation leader structure which match 'name' or NULL if not found.

Definition at line 267 of file nation.c.

Referenced by generate_players(), player_nation_defaults(), races_leader_callback(), and server_player_name_is_allowed().

◆ nation_leader_destroy()

static void nation_leader_destroy ( struct nation_leader pleader)
static

Destroy a nation leader created with nation_leader_new().

Definition at line 256 of file nation.c.

Referenced by nation_init().

◆ nation_leader_is_male()

bool nation_leader_is_male ( const struct nation_leader pleader)

◆ nation_leader_name()

const char * nation_leader_name ( const struct nation_leader pleader)

◆ nation_leader_new()

struct nation_leader * nation_leader_new ( struct nation_type pnation,
const char name,
bool  is_male 
)

Create a new leader for the nation.

Definition at line 239 of file nation.c.

Referenced by handle_ruleset_nation(), and load_ruleset_nations().

◆ nation_leaders()

const struct nation_leader_list * nation_leaders ( const struct nation_type pnation)

◆ nation_legend_translation()

const char * nation_legend_translation ( const struct nation_type pnation,
const char legend 
)

Return translated version of nation legend.

Definition at line 299 of file nation.c.

Referenced by handle_ruleset_nation().

◆ nation_number()

Nation_type_id nation_number ( const struct nation_type pnation)

◆ nation_of_city()

struct nation_type * nation_of_city ( const struct city pcity)

◆ nation_of_player()

struct nation_type * nation_of_player ( const struct player pplayer)

◆ nation_of_unit()

struct nation_type * nation_of_unit ( const struct unit punit)

◆ nation_plural_for_player()

const char * nation_plural_for_player ( const struct player pplayer)

Return the (translated) plural noun of the given nation of a player. You don't have to free the return pointer.

Definition at line 178 of file nation.c.

Referenced by diplo_dlg::add_widget(), announce_player(), announce_trade_route_removal(), api_edit_give_technology(), change_build_target(), check_for_game_over(), city_build_building(), civil_war(), client_diplomacy_clause_string(), create_barbarian_player(), create_command_newcomer(), create_diplomacy_dialog(), dem_line_item(), diplo_wdg::diplo_wdg(), diplomat_bribe(), diplomat_embassy(), diplomat_sabotage(), do_capture_units(), do_expel_unit(), do_nuclear_explosion(), do_nuke_tile(), do_unit_establish_trade(), do_unit_strike_city_building(), do_unit_strike_city_production(), do_wipe_units(), fit_nationset_to_players(), forget_tech_transferred(), government_change(), handle_diplomacy_accept_treaty_req(), handle_diplomacy_cancel_pact(), handle_player_change_government(), handle_spaceship_launch(), historian_generic(), is_allowed_city_name(), kill_player(), make_contact(), plr_widget::nation_selected(), notify_global_caught(), notify_global_success(), notify_victim_caught(), notify_victim_success(), players_vision_callback(), players_vision_callback(), players_war_callback(), players_war_callback(), qtg_init_meeting(), redraw_unit_info_label(), remove_illegal_armistice_units(), research_pretty_name(), mr_menu::save_image(), sg_load_players(), sg_load_players(), show_new_turn_info(), spy_nuke_city(), spy_sabotage_unit(), spy_spread_plague(), spy_steal_gold(), spy_steal_some_maps(), steal_a_tech(), tech_transfer(), transfer_unit(), update_diplomatics(), update_info_label(), and fc_client::update_sidebar_tooltips().

◆ nation_plural_translation()

const char * nation_plural_translation ( const struct nation_type pnation)

◆ nation_rule_name()

const char * nation_rule_name ( const struct nation_type pnation)

◆ nation_set_by_number()

struct nation_set * nation_set_by_number ( int  id)

Return the nation set with the given index.

This function returns NULL for an out-of-range index (some callers rely on this).

Definition at line 762 of file nation.c.

Referenced by fit_nationset_to_players(), handle_ruleset_nation(), load_ruleset_nations(), nation_set_by_setting_value(), next_set_callback(), and prev_set_callback().

◆ nation_set_by_rule_name()

struct nation_set * nation_set_by_rule_name ( const char name)

Return the nation set that has the given (untranslated) rule name. Returns NULL if no set is found.

Definition at line 779 of file nation.c.

Referenced by load_ruleset_nations(), nation_group_new(), nation_set_by_setting_value(), nation_set_new(), nationset_callback(), nationset_callback(), and races_dialog::nationset_changed().

◆ nation_set_by_setting_value()

struct nation_set * nation_set_by_setting_value ( const char setting)

Returns the nation set that would be selected by the given value of the 'nationset' server setting. This differs from nation_set_by_rule_name() for the empty string, where the first (ruleset default) nationset will be used; and similarly for a nationset not matched in the ruleset. The knowledge of the interpretation of this setting encapsulated here is required on both server and client.

Definition at line 859 of file nation.c.

Referenced by client_current_nation_set(), current_nationset(), nationset_callback(), races_dialog::nationset_changed(), nationset_sync_to_server(), popup_races_dialog(), and races_dialog::update_nationset_combo().

◆ nation_set_count()

int nation_set_count ( void  )

◆ nation_set_description()

const char * nation_set_description ( const struct nation_set pset)

Return the (untranslated) user description of a nation set. You don't have to free the return pointer.

Definition at line 828 of file nation.c.

Referenced by create_races_dialog(), save_nations_ruleset(), send_ruleset_nations(), show_nationsets(), and races_dialog::update_nationset_combo().

◆ nation_set_index()

int nation_set_index ( const struct nation_set pset)

◆ nation_set_iter_get()

static void * nation_set_iter_get ( const struct iterator iter)
static

Implementation of iterator 'get' function.

Definition at line 905 of file nation.c.

Referenced by nation_set_iter_init().

◆ nation_set_iter_init()

struct iterator * nation_set_iter_init ( struct nation_set_iter it)

Implementation of iterator 'init' function.

Definition at line 922 of file nation.c.

◆ nation_set_iter_next()

static void nation_set_iter_next ( struct iterator iter)
static

Implementation of iterator 'next' function.

Definition at line 897 of file nation.c.

Referenced by nation_set_iter_init().

◆ nation_set_iter_sizeof()

size_t nation_set_iter_sizeof ( void  )

Implementation of iterator 'sizeof' function.

Definition at line 889 of file nation.c.

◆ nation_set_iter_valid()

static bool nation_set_iter_valid ( const struct iterator iter)
static

Implementation of iterator 'valid' function.

Definition at line 913 of file nation.c.

Referenced by nation_set_iter_init().

◆ nation_set_name_translation()

const char * nation_set_name_translation ( const struct nation_set pset)

Return the translated name of a nation set. You don't have to free the return pointer.

Definition at line 818 of file nation.c.

Referenced by create_races_dialog(), popup_races_dialog(), races_dialog::races_dialog(), and show_nationsets().

◆ nation_set_new()

struct nation_set * nation_set_new ( const char set_name,
const char set_rule_name,
const char set_description 
)

Add new set into the array of nation sets.

Definition at line 716 of file nation.c.

Referenced by handle_ruleset_nation_sets(), and load_ruleset_nations().

◆ nation_set_number()

int nation_set_number ( const struct nation_set pset)

Return the nation set index.

Definition at line 708 of file nation.c.

Referenced by load_ruleset_nations(), and send_ruleset_nations().

◆ nation_set_rule_name()

const char * nation_set_rule_name ( const struct nation_set pset)

Return the (untranslated) rule name of a nation set. You don't have to free the return pointer.

Definition at line 807 of file nation.c.

Referenced by create_races_dialog(), fit_nationset_to_players(), load_ruleset_nations(), next_set_callback(), prev_set_callback(), races_dialog::races_dialog(), save_nation(), save_nations_ruleset(), send_ruleset_nations(), and show_nationsets().

◆ nation_set_untranslated_name()

const char * nation_set_untranslated_name ( const struct nation_set pset)

Return the untranslated name of a nation set (including qualifier, if any). You usually want nation_set_rule_name() instead. You don't have to free the return pointer.

Definition at line 797 of file nation.c.

Referenced by save_nations_ruleset(), and send_ruleset_nations().

◆ nation_sets_groups_free()

void nation_sets_groups_free ( void  )

Frees and resets all nation set/group data.

Definition at line 1178 of file nation.c.

Referenced by game_ruleset_free().

◆ nation_sets_groups_init()

void nation_sets_groups_init ( void  )

Initializes all nation set/group data.

Definition at line 1170 of file nation.c.

Referenced by game_ruleset_init().

◆ nations_alloc()

void nations_alloc ( int  num)

Allocate space for the given number of nations.

Definition at line 622 of file nation.c.

Referenced by handle_ruleset_control(), and load_nation_names().

◆ nations_free()

void nations_free ( void  )

De-allocate the currently allocated nations.

Definition at line 637 of file nation.c.

Referenced by game_ruleset_free().

◆ nations_match()

int nations_match ( const struct nation_type pnation1,
const struct nation_type pnation2,
bool  ignore_conflicts 
)

Returns how much two nations look good in the same game. Nations in the same group are considered to match, if that nation group has a 'match' greater than zero. Negative return value means that we really really don't want these nations together. This is dictated by "conflicts_with" in individual nation definitions. (If 'ignore_conflicts' is set, conflicts are not taken into account at all.) Server side function.

Definition at line 1206 of file nation.c.

Referenced by create_command_newcomer(), and pick_a_nation().

◆ style_of_nation()

struct nation_style * style_of_nation ( const struct nation_type pnation)

Variable Documentation

◆ nation_groups

struct nation_group nation_groups[MAX_NUM_NATION_GROUPS]
static

◆ nation_sets

struct nation_set nation_sets[MAX_NUM_NATION_SETS]
static

◆ nations

struct nation_type* nations = NULL
static

◆ num_nation_groups

int num_nation_groups
static

◆ num_nation_sets

int num_nation_sets
static