Classes
struct	unit::upkeep_full

struct	unit::upkeep_loyal

class	unit::upkeep_value_visitor
	Visitor helper class to fetch the appropriate upkeep value. More...

struct	unit::upkeep_type_visitor
	Visitor helper struct to fetch the upkeep type flag if applicable, or the the value otherwise. More...

class	unit::upkeep_parser_visitor
	Visitor helper class to parse the upkeep value from a config. More...

Typedefs
using	unit::upkeep_t = utils::variant< upkeep_full, upkeep_loyal, int >

Functions
void	unit::generate_traits (bool must_have_only=false)
	Applies mandatory traits (e.g. More...

const std::vector< t_string > &	unit::trait_names () const
	Gets the names of the currently registered traits. More...

const std::vector< t_string > &	unit::trait_descriptions () const
	Gets the descriptions of the currently registered traits. More...

std::vector< std::string >	unit::trait_nonhidden_ids () const
	Gets the ids of the traits corresponding to those returned by trait_names() and trait_descriptions(). More...

std::vector< std::string >	unit::get_traits_list () const
	Gets a list of the traits this unit currently has, including hidden traits. More...

void	unit::add_trait_description (const config &trait, const t_string &description)
	Register a trait's name and its description for the UI's use. More...

int	unit::upkeep () const
	Gets the amount of gold this unit costs a side per turn. More...

upkeep_t	unit::upkeep_raw () const
	Gets the raw variant controlling the upkeep value. More...

void	unit::set_upkeep (upkeep_t v)
	Sets the upkeep value to a specific value value. More...

bool	unit::loyal () const
	Gets whether this unit is loyal - ie, it costs no upkeep. More...

bool	unit::is_fearless () const
	Gets whether this unit is fearless - ie, unaffected by time of day. More...

bool	unit::is_healthy () const
	Gets whether this unit is healthy - ie, always rest heals. More...

Detailed Description

Typedef Documentation

◆ upkeep_t

using unit::upkeep_t = utils::variant<upkeep_full, upkeep_loyal, int>

Definition at line 1158 of file unit.hpp.

Function Documentation

◆ add_trait_description()

void unit::add_trait_description	(	const config &	trait,
		const t_string &	description
	)

Register a trait's name and its description for the UI's use.

The resulting data can be fetched with trait_names and trait_descriptions.

Parameters

trait	A config containing the trait's attributes.
description	The translatable description of the trait.

Definition at line 2544 of file unit.cpp.

References t_string::empty(), unit_race::FEMALE, unit::gender_, gender_string(), unit::name(), unit::trait_descriptions_, unit::trait_names_, and unit::trait_nonhidden_ids_.

Referenced by unit::add_modification().

◆ generate_traits()

void unit::generate_traits ( bool must_have_only = false )

Applies mandatory traits (e.g.

undead, mechanical) to a unit and then fills in the remaining traits traits until no more are available (leaders have a restricted set of available traits) or the unit has its maximum number of traits.

This routine does not apply the effects of added traits to a unit; that must be done by the caller.

Note that random numbers used in config files don't work in multiplayer, so leaders should be barred from all random traits until that is fixed. Later the restrictions will be based on play balance.

Parameters

must_have_only Whether random or optional traits should be included or not. If false only mandatory traits will be used.

Definition at line 758 of file unit.cpp.

References config::add_child(), c, unit::can_recruit(), config::child_range(), config::erase(), randomness::generator, randomness::rng::get_random_int(), unit_type::log_id(), LOG_UT, unit::modifications_, unit_type::num_traits(), unit_type::possible_traits(), unit::random_traits_, s, utils::split(), t, and unit::type().

Referenced by unit::advance_to().

◆ get_traits_list()

std::vector< std::string > unit::get_traits_list ( ) const

Gets a list of the traits this unit currently has, including hidden traits.

Returns: A list of trait IDs.

Definition at line 891 of file unit.cpp.

References config::child_range(), and unit::modifications_.

Referenced by gui2::dialogs::add_unit_entry(), unit_filter_impl::unit_filter_compound::fill(), and wfl::unit_callable::get_value().

◆ is_fearless()

bool unit::is_fearless ( ) const

inline

Gets whether this unit is fearless - ie, unaffected by time of day.

Definition at line 1268 of file unit.hpp.

References unit::is_fearless_.

Referenced by attack_info(), battle_context_unit_stats::battle_context_unit_stats(), gui2::dialogs::attack_predictions::set_data(), and unit_alignment().

◆ is_healthy()

bool unit::is_healthy ( ) const

inline

Gets whether this unit is healthy - ie, always rest heals.

Definition at line 1274 of file unit.hpp.

References unit::is_healthy_.

◆ loyal()

bool unit::loyal ( ) const

Gets whether this unit is loyal - ie, it costs no upkeep.

Definition at line 1747 of file unit.cpp.

References unit::upkeep_.

Referenced by gui2::dialogs::unit_recall::dismiss_unit().

◆ set_upkeep()

void unit::set_upkeep ( upkeep_t v )

inline

Sets the upkeep value to a specific value value.

Does not necessarily need to be numeric

Definition at line 1259 of file unit.hpp.

References unit::upkeep_.

◆ trait_descriptions()

const std::vector<t_string>& unit::trait_descriptions ( ) const

inline

Gets the descriptions of the currently registered traits.

Returns: A list of translatable trait descriptions.

Definition at line 1103 of file unit.hpp.

References unit::trait_descriptions_.

Referenced by gui2::unit_preview_pane::set_displayed_unit(), and unit_traits().

◆ trait_names()

const std::vector<t_string>& unit::trait_names ( ) const

inline

Gets the names of the currently registered traits.

Returns: A list of translatable trait names.

Definition at line 1093 of file unit.hpp.

References unit::trait_names_.

Referenced by gui2::dialogs::unit_list::pre_show(), gui2::dialogs::unit_recall::pre_show(), gui2::dialogs::unit_recall::rename_unit(), gui2::unit_preview_pane::set_displayed_unit(), and unit_traits().

◆ trait_nonhidden_ids()

std::vector<std::string> unit::trait_nonhidden_ids ( ) const

inline

Gets the ids of the traits corresponding to those returned by trait_names() and trait_descriptions().

Omits hidden traits, which are those with an empty name.

Returns: A list of trait IDs.

Definition at line 1114 of file unit.hpp.

References unit::trait_nonhidden_ids_.

Referenced by unit_traits().

◆ upkeep()

int unit::upkeep ( ) const

Gets the amount of gold this unit costs a side per turn.

This fetches an actual numeric gold value:

If can_recruit is true, no upkeep is paid (0 is returned).
If a special upkeep flag is set, the associated gold amount is returned (see upkeep_value_visitor).
If a numeric value is already set, it is returned directly.

Returns: A gold value, evaluated based on the state of upkeep_raw.

Definition at line 1737 of file unit.cpp.

References unit::can_recruit(), and unit::upkeep_.

Referenced by unit_filter_impl::unit_filter_compound::fill(), wfl::unit_callable::get_value(), unit::parse_upkeep(), and unit::write_upkeep().

◆ upkeep_raw()

upkeep_t unit::upkeep_raw ( ) const

inline

Gets the raw variant controlling the upkeep value.

This should not usually be called directly. To get an actual numeric value of upkeep use upkeep.

Definition at line 1253 of file unit.hpp.

References unit::upkeep_.

Classes

Typedefs

Functions

Detailed Description

Typedef Documentation

◆ upkeep_t

Function Documentation

◆ add_trait_description()

◆ generate_traits()

◆ get_traits_list()

◆ is_fearless()

◆ is_healthy()

◆ loyal()

◆ set_upkeep()

◆ trait_descriptions()

◆ trait_names()

◆ trait_nonhidden_ids()

◆ upkeep()

◆ upkeep_raw()