government.h

Go to the documentation of this file.

/***********************************************************************
 Freeciv - Copyright (C) 1996 - A Kjeldberg, L Gregersen, P Unold
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.
 
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
***********************************************************************/
#ifndef FC__GOVERNMENT_H
#define FC__GOVERNMENT_H
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
/* utility */
#include "shared.h"
 
/* common */
#include "fc_types.h"
#include "name_translation.h"
#include "requirements.h"
 
#define GOVF_LAST_USER_FLAG GOVF_USER_FLAG_8
#define MAX_NUM_USER_GOVERNMENT_FLAGS (GOVF_LAST_USER_FLAG - GOVF_USER_FLAG_1 + 1)
 
struct strvec;          /* Actually defined in "utility/string_vector.h". */
 
struct ruler_title;     /* Opaque type. */
 
/* 'struct ruler_title_hash' and related functions. */
#define SPECHASH_TAG ruler_title
#define SPECHASH_IKEY_TYPE struct nation_type *
#define SPECHASH_IDATA_TYPE struct ruler_title *
#include "spechash.h"
#define ruler_titles_iterate(ARG_hash, NAME_rule_title)                     \
  TYPED_HASH_DATA_ITERATE(const struct ruler_title *, ARG_hash,             \
                          NAME_rule_title)
#define ruler_titles_iterate_end HASH_DATA_ITERATE_END
 
/* G_LAST is a value guaranteed to be larger than any valid
 * Government_type_id. It defines the maximum number of governments
 * (so can also be used to size static arrays indexed by governments);
 * it is sometimes used as a sentinel value (but not in the network
 * protocol, which generally uses government_count()). */
#define G_LAST (127)
 
/* This is struct government itself. All information about a form of
 * government is contained inhere. -- SKi */
struct government {
  Government_type_id item_number;
  struct name_translation name;
  bool ruledit_disabled;
  void *ruledit_dlg;
  char graphic_str[MAX_LEN_NAME];
  char graphic_alt[MAX_LEN_NAME];
  char sound_str[MAX_LEN_NAME];
  char sound_alt[MAX_LEN_NAME];
  char sound_alt2[MAX_LEN_NAME];
  struct requirement_vector reqs;
  struct ruler_title_hash *ruler_titles;
  int changed_to_times;
  bv_gov_flags flags;
  struct strvec *helptext;
 
  /* AI cached data for this government. */
  struct {
    struct government *better; /* Hint: A better government (or nullptr) */
  } ai;
};
 
 
/* General government accessor functions. */
Government_type_id government_count(void);
Government_type_id government_index(const struct government *pgovern)
  fc__attribute((nonnull(1)));
Government_type_id government_number(const struct government *pgovern)
  fc__attribute((nonnull(1)));
 
struct government *government_by_number(const Government_type_id gov);
struct government *government_of_player(const struct player *pplayer)
  fc__attribute((nonnull(1)));
struct government *government_of_city(const struct city *pcity)
  fc__attribute((nonnull(1)));
 
struct government *government_by_rule_name(const char *name);
struct government *government_by_translated_name(const char *name);
 
const char *government_rule_name(const struct government *pgovern)
  fc__attribute((nonnull(1)));
const char *government_name_translation(const struct government *pgovern)
  fc__attribute((nonnull(1)));
const char *government_name_for_player(const struct player *pplayer);
 
/* Ruler titles. */
const struct ruler_title_hash *
government_ruler_titles(const struct government *pgovern)
  fc__attribute((nonnull(1)));
struct ruler_title *
government_ruler_title_new(struct government *pgovern,
                           const struct nation_type *pnation,
                           const char *ruler_male_title,
                           const char *ruler_female_title);
 
const struct nation_type *
ruler_title_nation(const struct ruler_title *pruler_title);
const char *
ruler_title_male_untranslated_name(const struct ruler_title *pruler_title);
const char *
ruler_title_female_untranslated_name(const struct ruler_title *pruler_title);
 
const char *ruler_title_for_player(const struct player *pplayer,
                                   char *buf, size_t buf_len)
  fc__attribute((nonnull(2)));
const char *default_title_for_player(const struct player *pplayer,
                                     char *buf, size_t buf_len);
 
/* Ancillary routines */
bool can_change_to_government(struct player *pplayer,
                              const struct government *pgovern)
  fc__attribute((nonnull(2)));
 
/* Initialization and iteration */
void governments_alloc(int num);
void governments_free(void);
 
struct government_iter;
size_t government_iter_sizeof(void);
struct iterator *government_iter_init(struct government_iter *it);
 
/* Iterate over government types. */
#define governments_iterate(NAME_pgov)                                      \
  generic_iterate(struct government_iter, struct government *,              \
                  NAME_pgov, government_iter_sizeof, government_iter_init)
#define governments_iterate_end generic_iterate_end
 
#define governments_re_active_iterate(_p)                               \
  governments_iterate(_p) {                                             \
    if (!_p->ruledit_disabled) {
 
#define governments_re_active_iterate_end                               \
    }                                                                   \
  } governments_iterate_end;
 
bool untargeted_revolution_allowed(void);
 
/* General government flag accessor routines */
bool government_has_flag(const struct government *pgov,
                         enum gov_flag_id flag);
 
void user_gov_flags_init(void);
void gov_flags_free(void);
void set_user_gov_flag_name(enum gov_flag_id id,
                            const char *name,
                            const char *helptxt);
const char *gov_flag_helptxt(enum gov_flag_id id);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* FC__GOVERNMENT_H */