BIS fnc decodeFlags8: Difference between revisions

Latest revision as of 21:02, 24 June 2025

Hover & click on the images for description

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

Syntax:: [encodedFlags, size] call BIS_fnc_decodeFlags8
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 = 4311 call BIS_fnc_decodeFlags8; // [7,2,3,0,1]
Example 2:: private _decodedFlags = [4311, 8] call BIS_fnc_decodeFlags8; // [7,2,3,0,1,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 1: / Line 1: @@
 {{RV|type=function
-| arma3
+|game1= arma3
+|version1= 1.00
-|1.00
+|gr1= Bitwise
-|gr1 = Bitwise
+|descr= Decodes a single scalar into array of unique 8-state flags (values 0,1,2,3,4,5,6,7).
-| <pre>/*
+|s1= [encodedFlags, size] call [[BIS_fnc_decodeFlags8]]
-	Decodes a single scalar into array of unique 8-state flags (values 0,1,2,3,4,5,6,7). Max. number that can be decoded is 16777215 (= 8^8 - 1). An optional parameter can by supplied to resize the output.
-	Syntax:
+|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
-	_flags:array = _encodedFlags:scalar call bis_fnc_decodeFlags8;
-	_flags:array = [_encodedFlags:scalar,_size:scalar] call bis_fnc_decodeFlags8;
-	Example:
+|r1= [[Number]] - decoded flags
-	--------
-	[7,2,3,0,1] = 4311 call bis_fnc_decodeFlags8;
-	[7,2,3,0,1,0,0,0] = [4311,8] call bis_fnc_decodeFlags8;
-	Explanation:
+|x1= <sqf>private _decodedFlags = 4311 call BIS_fnc_decodeFlags8; // [7,2,3,0,1]</sqf>
-	------------
+|x2= <sqf>private _decodedFlags = [4311, 8] call BIS_fnc_decodeFlags8; // [7,2,3,0,1,0,0,0]</sqf>
--> 0001 0000 1101 0111 -> 001 000 011 010 111 -> [7,2,3,0,1]
-*/</pre>{{placeholder}}<!-- Remove this after fill-in -->
-|s1= [] call [[BIS_fnc_decodeFlags8]]
+|seealso= [[BIS_fnc_encodeFlags8]]
-|p1=
-|r1=
-|x1=
 }}
-[[Category:{{Name|arma3}}: Functions|{{uc:decodeFlags8}}]]