BIS fnc decodeFlags4: Difference between revisions

Latest revision as of 20:40, 24 June 2025

Hover & click on the images for description

Description:: Decodes a single scalar into array of unique 4-state flags (values 0,1,2,3).
Execution:: call
Groups:: Bitwise

Syntax:: [encodedFlags, size] call BIS_fnc_decodeFlags4
Parameters:: encodedFlags: Number - non-decimal number between 0 and 16777215
: size: Number - (Optional, default -1) output size. Size -1 means output will not be resized
Return Value:: Number - decoded flags

Example 1:: private _decodedFlags = 225 call BIS_fnc_decodeFlags4; // [1,0,2,3]
Example 2:: private _decodedFlags = [225, 8] call BIS_fnc_decodeFlags4; // [1,0,2,3,0,0,0,0]

: 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

@@ Line 6: / Line 6: @@
 |gr1= Bitwise
-|descr= <pre>/*
+|descr= Decodes a single scalar into array of unique 4-state flags (values 0,1,2,3).
-	Decodes a single scalar into array of unique 4-state flags (values 0,1,2,3). Max. number that can be decoded is 16777215 (= 4^12 - 1). An optional parameter can by supplied to resize the output.
-	Syntax:
+|s1= [encodedFlags, size] call [[BIS_fnc_decodeFlags4]]
-	-------
-	_flags:array = _encodedFlags:scalar call bis_fnc_decodeFlags4;
-	_flags:array = [_encodedFlags:scalar,_size:scalar] call bis_fnc_decodeFlags4;
-	Example:
+|p1= encodedFlags: [[Number]] - non-decimal number between 0 and 16777215
-	--------
+|p2= size: [[Number]] - (Optional, default -1) output size. Size -1 means output will not be resized
-	[1,0,2,3] = 225 call bis_fnc_decodeFlags4;
-	[1,0,2,3,0,0,0,0] = [225,8] call bis_fnc_decodeFlags4;
-	Explanation:
+|r1= [[Number]] - decoded flags
-	------------
--> 11 10 00 01 -> [1,0,2,3]
-*/</pre>{{Wiki|placeholder}}<!-- Remove this after fill-in -->
-|s1= [] call [[BIS_fnc_decodeFlags4]]
+|x1= <sqf>private _decodedFlags = 225 call BIS_fnc_decodeFlags4; // [1,0,2,3]</sqf>
+|x2= <sqf>private _decodedFlags = [225, 8] call BIS_fnc_decodeFlags4; // [1,0,2,3,0,0,0,0]</sqf>
-|p1=
+|seealso= [[BIS_fnc_encodeFlags4]]
-|r1=
-|x1=
 }}
-[[Category:{{Name|arma3}}: Functions|{{uc:decodeFlags4}}]]