BIS fnc bitflagsUnset: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| *arma3 * * *\| *([0-2]\.[0-9]{2}) * " to "|game1= arma3 |version1= $1 ")
m (Text replacement - " |r1=[[" to " |r1= [[")
Line 19: Line 19:
|p2= flag: [[Number]] - one or more flags to unset
|p2= flag: [[Number]] - one or more flags to unset


|r1=[[Number]]  - new flagset with given flag or flags unset
|r1= [[Number]]  - new flagset with given flag or flags unset


|x1=<code>[2 + 4 + 8, 8] [[call]] [[BIS_fnc_bitflagsUnset]]; // 6 (which is 2 + 4)
|x1=<code>[2 + 4 + 8, 8] [[call]] [[BIS_fnc_bitflagsUnset]]; // 6 (which is 2 + 4)

Revision as of 23:24, 7 August 2021

Hover & click on the images for description

Description

Description:
Unsets one or more flags in the given flagset, represented with decimal or hexadecimal number
(Hexadecimal number representation is simply auto-converted into decimal by the engine)
To check which flags are present in given flagset use BIS_fnc_bitflagsToArray

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, flag] call BIS_fnc_bitflagsUnset
Parameters:
flagset: Number - flagset
flag: Number - one or more flags to unset
Return Value:
Number - new flagset with given flag or flags unset

Examples

Example 1:
[2 + 4 + 8, 8] call BIS_fnc_bitflagsUnset; // 6 (which is 2 + 4) [2 + 4 + 8, 2 + 8] call BIS_fnc_bitflagsUnset; // 4 [2 + 4 + 8, 1 + 8] call BIS_fnc_bitflagsUnset; // 6 (which is 2 + 4) [2 + 4 + 8, 1 + 8 + 8 + 2 + 2] call BIS_fnc_bitflagsUnset; // 10 (which is 2 + 8, since 1 + 8 + 8 + 2 + 2 is in fact 1 + 4 + 16)

Additional Information

See also:
BIS fnc bitflagsFlipBIS fnc bitflagsCheckBIS fnc bitflagsToArrayBIS fnc bitflagsSet

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