Represents a soldier hired by the player. More...

#include <Soldier.h>

Public Member Functions
	Soldier (RuleSoldier rules, Armor armor, int id=0)
	Creates a new soldier. More...

	~Soldier ()
	Cleans up the soldier.

void	load (const YAML::Node &node, const Mod mod, SavedGame save)
	Loads the soldier from YAML. More...

YAML::Node	save () const
	Saves the soldier to YAML. More...

std::string	getName (bool statstring=false, unsigned int maxLength=20) const
	Gets the soldier's name. More...

void	setName (const std::string &name)
	Sets the soldier's name. More...

Craft *	getCraft () const
	Gets the soldier's craft. More...

void	setCraft (Craft *craft)
	Sets the soldier's craft. More...

std::string	getCraftString (Language *lang) const
	Gets the soldier's craft string. More...

std::string	getRankString () const
	Gets a string version of the soldier's rank. More...

int	getRankSprite () const
	Gets a sprite version of the soldier's rank. More...

SoldierRank	getRank () const
	Gets the soldier's rank. More...

void	promoteRank ()
	Increase the soldier's military rank.

int	getMissions () const
	Gets the soldier's missions. More...

int	getKills () const
	Gets the soldier's kills. More...

SoldierGender	getGender () const
	Gets the soldier's gender. More...

SoldierLook	getLook () const
	Gets the soldier's look. More...

RuleSoldier *	getRules () const
	Gets soldier rules. More...

int	getId () const
	Gets the soldier's unique ID. More...

void	addMissionCount ()
	Add a mission to the counter.

void	addKillCount (int count)
	Add a kill to the counter.

UnitStats *	getInitStats ()
	Get pointer to initial stats.

UnitStats *	getCurrentStats ()
	Get pointer to current stats.

bool	isPromoted ()
	Get whether the unit was recently promoted. More...

Armor *	getArmor () const
	Gets the soldier armor. More...

void	setArmor (Armor *armor)
	Sets the soldier armor. More...

int	getWoundRecovery () const
	Gets the soldier's wound recovery time. More...

void	setWoundRecovery (int recovery)
	Sets the soldier's wound recovery time. More...

void	heal ()
	Heals wound recoveries. More...

std::vector< EquipmentLayoutItem * > *	getEquipmentLayout ()
	Gets the soldier's equipment-layout. More...

void	trainPsi ()
	Trains a soldier's psychic stats. More...

void	trainPsi1Day ()
	Trains a soldier's psionic abilities (anytimePsiTraining option). More...

bool	isInPsiTraining () const
	Returns whether the unit is in psi training or not. More...

void	setPsiTraining ()
	set the psi training status More...

int	getImprovement () const
	returns this soldier's psionic skill improvement score for this month. More...

int	getPsiStrImprovement () const
	returns this soldier's psionic strength improvement score for this month.

SoldierDeath *	getDeath () const
	Gets the soldier death info. More...

void	die (SoldierDeath *death)
	Kills the soldier. More...

SoldierDiary *	getDiary ()
	Gets the soldier's diary. More...

void	calcStatString (const std::vector< StatString *> &statStrings, bool psiStrengthEval)
	Calculate statString. More...

Detailed Description

Represents a soldier hired by the player.

Soldiers have a wide variety of stats that affect their performance during battles.

Constructor & Destructor Documentation

◆ Soldier()

OpenXcom::Soldier::Soldier	(	RuleSoldier *	rules,
		Armor *	armor,
		int	id = `0`
	)

Creates a new soldier.

Initializes a new soldier, either blank or randomly generated.

Parameters

rules	Soldier ruleset.
armor	Soldier armor.
id	Unique soldier id for soldier generation.

Member Function Documentation

◆ calcStatString()

void OpenXcom::Soldier::calcStatString	(	const std::vector< StatString *> &	statStrings,
		bool	psiStrengthEval
	)

Calculate statString.

Calculates the soldier's statString Calculates the soldier's statString.

Parameters

statStrings	List of statString rules.
psiStrengthEval	Are psi stats available?

◆ die()

void OpenXcom::Soldier::die ( SoldierDeath * death )

Kills the soldier.

Kills the soldier in the Geoscape.

Parameters

death Pointer to death data.

◆ getArmor()

Armor * OpenXcom::Soldier::getArmor ( ) const

Gets the soldier armor.

Returns the unit's current armor.

Returns: Pointer to armor data.

◆ getCraft()

Craft * OpenXcom::Soldier::getCraft ( ) const

Gets the soldier's craft.

Returns the craft the soldier is assigned to.

Returns: Pointer to craft.

◆ getCraftString()

std::string OpenXcom::Soldier::getCraftString ( Language * lang ) const

Gets the soldier's craft string.

Returns the soldier's craft string, which is either the soldier's wounded status, the assigned craft name, or none.

Parameters

lang	Language to get strings from.

Returns: Full name.

◆ getDeath()

SoldierDeath * OpenXcom::Soldier::getDeath ( ) const

Gets the soldier death info.

Returns the soldier's death details.

Returns: Pointer to death data. NULL if no death has occurred.

◆ getDiary()

SoldierDiary * OpenXcom::Soldier::getDiary ( )

Gets the soldier's diary.

Returns the soldier's diary.

Returns: Diary.

◆ getEquipmentLayout()

std::vector< EquipmentLayoutItem * > * OpenXcom::Soldier::getEquipmentLayout ( )

Gets the soldier's equipment-layout.

Returns the list of EquipmentLayoutItems of a soldier.

Returns: Pointer to the EquipmentLayoutItem list.

◆ getGender()

SoldierGender OpenXcom::Soldier::getGender ( ) const

Gets the soldier's gender.

Returns the soldier's gender.

Returns: Gender.

◆ getId()

int OpenXcom::Soldier::getId ( ) const

Gets the soldier's unique ID.

Returns the soldier's unique ID.

Each soldier can be identified by its ID. (not it's name)

Returns: Unique ID.

◆ getImprovement()

int OpenXcom::Soldier::getImprovement ( ) const

returns this soldier's psionic skill improvement score for this month.

Returns: score

◆ getKills()

int OpenXcom::Soldier::getKills ( ) const

Gets the soldier's kills.

Returns the soldier's amount of kills.

Returns: Kills.

◆ getLook()

SoldierLook OpenXcom::Soldier::getLook ( ) const

Gets the soldier's look.

Returns the soldier's look.

Returns: Look.

◆ getMissions()

int OpenXcom::Soldier::getMissions ( ) const

Gets the soldier's missions.

Returns the soldier's amount of missions.

Returns: Missions.

◆ getName()

std::string OpenXcom::Soldier::getName	(	bool	statstring = `false`,
		unsigned int	maxLength = `20`
	)		const

Gets the soldier's name.

Returns the soldier's full name (and, optionally, statString).

Parameters

statstring	Add stat string?
maxLength	Restrict length to a certain value.

Returns: Soldier name.

◆ getRank()

SoldierRank OpenXcom::Soldier::getRank ( ) const

Gets the soldier's rank.

Returns the soldier's military rank.

Returns: Rank enum.

◆ getRankSprite()

int OpenXcom::Soldier::getRankSprite ( ) const

Gets a sprite version of the soldier's rank.

Returns a graphic representation of the soldier's military rank.

Note: THE MEANING OF LIFE

Returns: Sprite ID for rank.

◆ getRankString()

std::string OpenXcom::Soldier::getRankString ( ) const

Gets a string version of the soldier's rank.

Returns a localizable-string representation of the soldier's military rank.

Returns: String ID for rank.

◆ getRules()

RuleSoldier * OpenXcom::Soldier::getRules ( ) const

Gets soldier rules.

Returns the soldier's rules.

Returns: rulesoldier

◆ getWoundRecovery()

int OpenXcom::Soldier::getWoundRecovery ( ) const

Gets the soldier's wound recovery time.

Returns the amount of time until the soldier is healed.

Returns: Number of days.

◆ heal()

void OpenXcom::Soldier::heal ( )

Heals wound recoveries.

Heals soldier wounds.

◆ isInPsiTraining()

bool OpenXcom::Soldier::isInPsiTraining ( ) const

Returns whether the unit is in psi training or not.

returns whether or not the unit is in psi training

Returns: true/false

◆ isPromoted()

bool OpenXcom::Soldier::isPromoted ( )

Get whether the unit was recently promoted.

Returns the unit's promotion status and resets it.

Returns: True if recently promoted, False otherwise.

◆ load()

void OpenXcom::Soldier::load	(	const YAML::Node &	node,
		const Mod *	mod,
		SavedGame *	save
	)

Loads the soldier from YAML.

Loads the soldier from a YAML file.

Parameters

node	YAML node.
mod	Game mod.
save	Pointer to savegame.

◆ save()

YAML::Node OpenXcom::Soldier::save ( ) const

Saves the soldier to YAML.

Saves the soldier to a YAML file.

Returns: YAML node.

◆ setArmor()

void OpenXcom::Soldier::setArmor ( Armor * armor )

Sets the soldier armor.

Changes the unit's current armor.

Parameters

armor Pointer to armor data.

◆ setCraft()

void OpenXcom::Soldier::setCraft ( Craft * craft )

Sets the soldier's craft.

Assigns the soldier to a new craft.

Parameters

craft Pointer to craft.

◆ setName()

void OpenXcom::Soldier::setName ( const std::string & name )

Sets the soldier's name.

Changes the soldier's full name.

Parameters

name	Soldier name.

◆ setPsiTraining()

void OpenXcom::Soldier::setPsiTraining ( )

set the psi training status

toggles whether or not the unit is in psi training

◆ setWoundRecovery()

void OpenXcom::Soldier::setWoundRecovery ( int recovery )

Sets the soldier's wound recovery time.

Changes the amount of time until the soldier is healed.

Parameters

recovery Number of days.

◆ trainPsi()

void OpenXcom::Soldier::trainPsi ( )

Trains a soldier's psychic stats.

Trains a soldier's Psychic abilities after 1 month.

◆ trainPsi1Day()

void OpenXcom::Soldier::trainPsi1Day ( )

Trains a soldier's psionic abilities (anytimePsiTraining option).

Trains a soldier's Psychic abilities after 1 day.

(anytimePsiTraining option)

The documentation for this class was generated from the following files:

Soldier.h
Soldier.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Soldier()

Member Function Documentation

◆ calcStatString()

◆ die()

◆ getArmor()

◆ getCraft()

◆ getCraftString()

◆ getDeath()

◆ getDiary()

◆ getEquipmentLayout()

◆ getGender()

◆ getId()

◆ getImprovement()

◆ getKills()

◆ getLook()

◆ getMissions()

◆ getName()

◆ getRank()

◆ getRankSprite()

◆ getRankString()

◆ getRules()

◆ getWoundRecovery()

◆ heal()

◆ isInPsiTraining()

◆ isPromoted()

◆ load()

◆ save()

◆ setArmor()

◆ setCraft()

◆ setName()

◆ setPsiTraining()

◆ setWoundRecovery()

◆ trainPsi()

◆ trainPsi1Day()