Arma 3 Scripting

Command in Config

getText

Also available as Markdown and JSON, or read the original wiki page.

Description

Extracts localized text from config entry, if entry is subject to localization, otherwise returns text value. To obtain the translation key itself, see getTextRaw.

Syntax

getText config

Parameters:

Returns: String - text value

Examples

Example 1

_text = getText (configFile >> "CfgVehicles" >> "Thing" >> "icon"); // "Get in %1 as Driver"

See also

configFile · a / b · configName · count · getArray · getNumber · inheritsFrom · isArray · isClass · isNumber · isText · select · getTextRaw

Community notes

ffur2007slx2_5

(Arma 3 1.14) It's recommended to use BIS_fnc_getCfgData or BIS_fnc_returnConfigEntry to get variable cfg data rather than conditioning via isNumber, isText, isArray, getNumber, getText and getArray combination.

Traditional workaround:

_cfg = configFile >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type";
switch ( true ) do
{
    case (isNumber _cfg): {getNumber _cfg};
    case (isText _cfg): {getText _cfg};
    case (isArray _cfg): {getArray _cfg;};
    default { nil };
};

Recommended workaround:

(configFile >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type") call BIS_fnc_getCfgData;

To return default value once entry was not found, we can use BIS_fnc_returnConfigEntry instead of BIS_fnc_getCfgData. e.g.

[(configFile >> "CannonFire" >> "LightExp"),"lifeTime",0] call BIS_fnc_returnConfigEntry;//0.5

To compose collected String into Array, use BIS_fnc_getCfgDataArray instead. E.g.

(configFile >> "CfgVehicles" >> _SomeAddonClassName >> "DestructionEffects" >> "Smoke1" >> "type") call BIS_fnc_getCfgDataArray;