BIS fnc bitflagsUnset: Difference between revisions

Revision as of 00:54, 31 October 2016

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

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:: Uncategorised

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 bitflagsFlip BIS fnc bitflagsCheck BIS fnc bitflagsToArray BIS 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

[[Category:Introduced with arma3dev version 1.65]][[ Category: arma3dev: New Functions | BIS FNC BITFLAGSUNSET]][[ Category: arma3dev: Functions | BIS FNC BITFLAGSUNSET]]

@@ Line 1: / Line 1: @@
+{{DISPLAYTITLE:BIS_fnc_bitflagsUnset}}
+{{Function|=
+____________________________________________________________________________________________
-{{Function|= Comments
+| arma3dev |=
-____________________________________________________________________________________________
+|1.65|=
-| arma3 |= Game name
+|arg= |= MPARGUMENTS
-|1.00|= Game version
+|eff= |= MPEFFECTS
 ____________________________________________________________________________________________
-| ''N/A'' |= Description
+| Unsets one or more flags in the given flagset, represented with decimal or hexadecimal number<br>
+(Hexadecimal number representation is simply auto-converted into decimal by the engine)<br>
+To check which flags are present in given flagset use [[BIS_fnc_bitflagsToArray]]<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) |=
 ____________________________________________________________________________________________
-| <!-- [] call [[BIS_fnc_bitflagsUnset]]; --> |= Syntax
+| [flagset, flag] call '''BIS_fnc_bitflagsUnset''' |=
-|p1= |= Parameter 1
-| |= Return value
+|p1= flagset: [[Number]] - flagset |=
-____________________________________________________________________________________________
+|p2= flag: [[Number]] - one or more flags to unset |=
+| [[Number]]  - new flagset with given flag or flags unset |= Return value
+|x1=<code>[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)</code>|= EXAMPLE1
+__________
+| [[BIS fnc bitflagsFlip]], [[BIS fnc bitflagsCheck]], [[BIS fnc bitflagsToArray]], [[BIS fnc bitflagsSet]]|= SEEALSO
-|x1= <code></code> |=
+|  |= MPBEHAVIOUR
 ____________________________________________________________________________________________
+}}
-| |= See also
-}}
+<h3 style='display:none'>Bottom Section</h3>
-<h3 style="display:none">Notes</h3>
 <dl class="command_description">
 <!-- Note Section BEGIN -->
 <!-- Note Section END -->
 </dl>
-<h3 style="display:none">Bottom Section</h3>
-[[Category:Function Group: Bitwise|{{uc:bitflagsUnset}}]]
-[[Category:Functions|{{uc:bitflagsUnset}}]]
 [[Category:{{Name|arma3}}: Functions|{{uc:bitflagsUnset}}]]