BIS fnc bitflagsToArray: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:BIS_fnc_bitflagsToArray}} {{Function|= ____________________________________________________________________________________________ | arma3dev |= |1.65|= |arg...")
m (Text replacement - " \|seealso *= *([^ ]*)\[\[BIS fnc ([a-zA-Z0-9_]+)\]\]([^ ]*)" to " |seealso= $1BIS_fnc_$2$3")
 
(48 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:BIS_fnc_bitflagsToArray}}
{{RV|type=function
{{Function|=
____________________________________________________________________________________________


| arma3dev |=
|game1= arma3
|1.65|=
|version1= 1.66


|arg= |= MPARGUMENTS
|gr1= Bitwise


|eff= |= MPEFFECTS
|descr= Returns array with all bit flags which are set in the given flagset<br><br>
____________________________________________________________________________________________
'''Limitations''':<br>
Due to various limitations of the Real Virtuality engine this function is
intended to work with unsigned 24 bit integers only. This means that the
supported range is 2^0...2^24 (1...16777216)


| Returns array with all bit flags which are set in the given flagset |=
|s1= flagset call [[BIS_fnc_bitflagsToArray]]
____________________________________________________________________________________________


| flagset call '''BIS_fnc_bitflagsToArray''' |=
|p1= flagset: [[Number]] - decimal or hexadecimal unsigned 24 bit integer


|p1= flagset: [[Number]] - decimal or hexadecimal unsigned 24 bit integer |=
|r1= [[Array]] - array of set bit flags


| [[Array]] - array of set bit flags  |= Return value
|x1=<sqf>15 call BIS_fnc_bitflagsToArray; // [1,2,4,8]
2342 call BIS_fnc_bitflagsToArray; // [2,4,32,256,2048]
[2 + 4 + 8] call BIS_fnc_bitflagsToArray; // [2,4,8]
[2 + 2 + 2 + 4 + 8 + 8 + 8] call BIS_fnc_bitflagsToArray; // [2,32]</sqf>


|x1=<code>15 [[call]] [[BIS_fnc_bitflagsToArray]]; // [1,2,4,8]
|seealso=     [[BIS_fnc_bitflagsFlip]] [[BIS_fnc_bitflagsSet]] [[BIS_fnc_bitflagsCheck]] [[BIS_fnc_bitflagsUnset]]
2342 [[call]] [[BIS_fnc_bitflagsToArray]]; // [2,4,32,256,2048]
[2 + 4 + 8] [[call]] [[BIS_fnc_bitflagsToArray]]; // [2,4,8]
[2 + 2 + 2 + 4 + 8 + 8 + 8] [[call]] [[BIS_fnc_bitflagsToArray]]; // [2,32]</code>|= EXAMPLE1
__________
 
| [[BIS fnc bitflagsFlip]], [[BIS fnc bitflagsSet]], [[BIS fnc bitflagsCheck]], [[BIS fnc bitflagsUnset]]|= SEEALSO
 
|  |= MPBEHAVIOUR
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Bottom Section</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
[[Category:{{Name|arma3}}: Functions|{{uc:bitflagsCheck}}]]

Latest revision as of 19:02, 13 July 2022

Arma 3 logo black.png1.66
Hover & click on the images for description

Description

Description:
Returns array with all bit flags which are set in the given flagset

Limitations:
Due to various limitations of the Real Virtuality engine this function is intended to work with unsigned 24 bit integers only. This means that the supported range is 2^0...2^24 (1...16777216)
Execution:
call
Groups:
Bitwise

Syntax

Syntax:
flagset call BIS_fnc_bitflagsToArray
Parameters:
flagset: Number - decimal or hexadecimal unsigned 24 bit integer
Return Value:
Array - array of set bit flags

Examples

Example 1:
15 call BIS_fnc_bitflagsToArray; // [1,2,4,8] 2342 call BIS_fnc_bitflagsToArray; // [2,4,32,256,2048] [2 + 4 + 8] call BIS_fnc_bitflagsToArray; // [2,4,8] [2 + 2 + 2 + 4 + 8 + 8 + 8] call BIS_fnc_bitflagsToArray; // [2,32]

Additional Information

See also:
BIS_fnc_bitflagsFlip BIS_fnc_bitflagsSet BIS_fnc_bitflagsCheck BIS_fnc_bitflagsUnset

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
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_bitflagsToArray&oldid=328601"