params

-wrong parameter ("arma3dev") defined!-[[:Category:Introduced with arma3dev version 1.45|1.45]]

Hover & click on the images for description

Description

Description:

Parses array of params into array of private variables. When used without argument, as shown in syntax 1, internal variable "_this", which is usually available inside functions and event handlers, is used as argument.
The values of passed argument array would be assigned to private variables given in the format array respectful of their order in the array. It is also possible to skip some values by giving empty string for a private variable name in format array.
To force variable value to a predefined value when nil is passed, use format for the private variable which is similar to getVariable <array> syntax, [variableName, defaultValue].
To make sure passed value is of a given type, supply the desired typeName. The command will throw an error and return false if validation fails. For "ARRAY" types it is also possible to validate the length of the passed array.
On successful parsing params returns true

Groups:

Uncategorised

Syntax

Syntax:

params [element1, element2,...elementN]

Parameters:

[element1, element2,...elementN]: Array - format array

elementN: String or Array
String is the name of a private variable (must begin with underscore _, e.g. "_myVar")
Array could be one of the following constructs:

• [variableName, defaultValue]
• [variableName, defaultValue, expectedType]
• [variableName, defaultValue, "ARRAY", expectedArrayLength]

variableName: String - name of a private variable (must begin with underscore _, e.g. "_myVar")
defaultValue: Anything - default value to assign to private variable if passed value is nil
expectedType: String - check if passed value is of a certain type, otherwise fail and return false
expectedArrayLength: Number - if passed value is of type "ARRAY", check that it is of a certain length, otherwise fail and return false

Return Value:

Boolean - true on success, false on failure

Alternative Syntax

Syntax:

argument params [element1, element2,...elementN]

Parameters:

argument: Anything - A usual array of params is expected. If a non-array value is passed, it will be converted to 1 element array

[element1, element2,...elementN]: Array - format array

elementN: String or Array:
String is the name of a private variable (must begin with underscore _, e.g. "_myVar")
Array could be one of the following constructs:

• [variableName, defaultValue]
• [variableName, defaultValue, expectedType]
• [variableName, defaultValue, "ARRAY", expectedArrayLength]

variableName: String - name of a private variable (must begin with underscore _, e.g. "_myVar")
defaultValue: Anything - default value to assign to private variable if passed value is nil
expectedType: String - check if passed value is of a certain type, otherwise fail and return false
expectedArrayLength: Number - if passed value is of type "ARRAY", check that it is of a certain length, otherwise fail and return false

Return Value:

Boolean - true on success, false on failure

Examples

Example 1:

[1,2,3] call { private ["_one","_two","_three"]; _one = _this select 0; _two = _this select 1; _three = _this select 2; ..... }; // same as above using params [1,2,3] call { params ["_one","_two","_three"]; ..... };

Example 2:

[123] call { params ["_myvar"]; }; // below would produce the same result as above 123 call { params ["_myvar"]; };

Example 3:

position player params ["","","_z"]; if (_z > 10) then { hint "YOU ARE FLYING!"; };

Example 4:

[1,nil,2] params ["_var1","_var2","_var3"]; // all 3 variables are made private // but only _var1 and _var3 are defined [1,nil,2] params ["_var1",["_var2",23],"_var3"]; // all 3 variables are private and defined

Example 5:

[1,2] call { if (!params ["_var1","_var2",["_var3",true,typeName true]]) exitwith {}; hint str [_var1,_var2,_var3]; }; // The hint shows [1,2,true] [1,2,3] call { if (!params ["_var1","_var2",["_var3",true,"BOOL"]]) exitwith {}; hint str [_var1,_var2,_var3]; }; // Error! Type Number, expected BOOL

Example 6:

Example 7:

<code

Example 8:

Example 9:

Example 10:

Additional Information

See also:

selectBIS_fnc_param

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

[[Category:Introduced with arma3dev version 1.45]][[ Category: arma3dev: New Scripting Commands | PARAMS]][[ Category: arma3dev: Scripting Commands | PARAMS]]