in: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (undo last changes due to broken syntax)
Tag: Undo
m (Replaced <code> with <sqf>)
Line 81: Line 81:
|r5= [[Boolean]]
|r5= [[Boolean]]


|x1= <code>1 in [0, 1, 2]; {{cc|true}}</code>
|x1= <sqf>1 in [0, 1, 2]; // true</sqf>


|x2= <code>[[private]] _myArray = ["Aaa", "AAa", "AAA"];
|x2= <sqf>private _myArray = ["Aaa", "AAa", "AAA"];


"aaa" [[in]] _myArray; {{cc|false}}
"aaa" in _myArray; // false
"AAa" [[in]] _myArray; {{cc|true}}
"AAa" in _myArray; // true


{{cc|case-insensitive alternatives}}
// Case-insensitive alternatives:
_myArray [[findIf]] { _x == "aaa"; } != -1; {{cc|true}}
_myArray findIf { _x == "aaa"; } != -1; // true


({
({
[[if]] ([[Magic Variables#x|_x]] == "aaa") [[exitWith]] { [[Magic Variables#forEachIndex|_forEachIndex]] };
if (_x == "aaa") exitWith { _forEachIndex };
-1
-1
} [[forEach]] _myArray) != -1; {{cc|true, less performant but valid before [[findIf]]}}
} forEach _myArray) != -1; // true, less performant but valid before the introduction of the findIf command


{ [[if]] ([[Magic Variables#x|_x]] == "aaa") [[exitWith]] {1} } [[count]] _myArray > 0; {{cc|true}}
{ if (_x == "aaa") exitWith { 1 } } count _myArray > 0; // true


{ [[Magic Variables#x|_x]] == "aaa"; } [[count]] _myArray > 0; {{cc|true, worst performance}}
{ _x == "aaa"; } count _myArray > 0; // true, worst performance, only option available in OFP</sqf>
{{cc|only option available in OFP}}</code>


|x3= <code>[1,2,3] in [<nowiki/>[1,2,3], [4,5,6]]; {{cc|true - [[:Category:Arma 3|{{arma3}}]] only}}</code>
|x3= <sqf>[1,2,3] in [[1,2,3], [4,5,6]]; // true - Arma 3 only</sqf>


|x4= <code>_isInCar = player in car;</code>
|x4= <sqf>private _isInCar = player in Car;</sqf>


|x5= <code>_isInside = [1000,2000,0] in myLocation;</code>
|x5= <sqf>private _isInside = [1000,2000,0] in MyLocation;</sqf>


|x6= <code>_isInString = "foo" [[in]] "foobar"; {{cc|true}}
|x6= <sqf>private _isInString = "foo" in "foobar"; // true
_isInString = "Foo" [[in]] "foobar"; {{cc|false}}</code>
_isInString = "Foo" in "foobar"; // false</sqf>


|x7= <code>[[private]] _onFoot = _unit [[in]] _unit;
|x7= <sqf>private _onFoot = _unit in _unit;</sqf>
{{cc|[[vehicle]] _unit {{=}}{{=}} _unit works}}
Other options:
{{cc|[[isNull]] [[objectParent]] _unit is even faster}}</code>
<sqf>private _onFoot = vehicle _unit == _unit;</sqf>
<sqf>private _onFoot = isNull objectParent _unit;</sqf>


|seealso= [[inPolygon]] [[inArea]] [[find]] [[findIf]] [[toArray]] [[forceUnicode]]
|seealso= [[inPolygon]] [[inArea]] [[find]] [[findIf]] [[toArray]] [[forceUnicode]]

Revision as of 16:09, 14 May 2022

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Checks whether value is in array, unit is in vehicle, position is inside location or ANSI string is part of other ANSI string. If Unicode support is desired, see forceUnicode.
ⓘ
String comparison is case-sensitive (see Examples 2 and 6).
Groups:
StringsArraysLocationsHashMapUnit Control

Syntax 1

Syntax:
value in array
Parameters:
value: Anything - Any value (cannot match Array before Arma 3)
array: Array - Array of values
Return Value:
Boolean

Syntax 2

Syntax:
unit in vehicle
Parameters:
unit: Object - Entity person
vehicle: Object - Entity vehicle
Return Value:
Boolean

Syntax 3

Syntax:
position in location
Parameters:
position: Array - Format Position2D or Position3D
location: Location
Return Value:
Boolean

Syntax 4

Syntax:
needle in haystack
Parameters:
needle: String - String to search for
haystack: String - String to search in
Return Value:
Boolean

Syntax 5

Syntax:
key in hashMap
Parameters:
key: HashMapKey
hashMap : HashMap
Return Value:
Boolean

Examples

Example 1:
1 in [0, 1, 2]; // true
Example 2:
private _myArray = ["Aaa", "AAa", "AAA"]; "aaa" in _myArray; // false "AAa" in _myArray; // true // Case-insensitive alternatives: _myArray findIf { _x == "aaa"; } != -1; // true ({ if (_x == "aaa") exitWith { _forEachIndex }; -1 } forEach _myArray) != -1; // true, less performant but valid before the introduction of the findIf command { if (_x == "aaa") exitWith { 1 } } count _myArray > 0; // true { _x == "aaa"; } count _myArray > 0; // true, worst performance, only option available in OFP
Example 3:
[1,2,3] in [[1,2,3], [4,5,6]]; // true - Arma 3 only
Example 4:
private _isInCar = player in Car;
Example 5:
private _isInside = [1000,2000,0] in MyLocation;
Example 6:
private _isInString = "foo" in "foobar"; // true _isInString = "Foo" in "foobar"; // false
Example 7:
private _onFoot = _unit in _unit;
Other options:
private _onFoot = vehicle _unit == _unit;
private _onFoot = isNull objectParent _unit;

Additional Information

See also:
inPolygon inArea find findIf toArray forceUnicode

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
Posted on October 8, 2019 - 21:08 (UTC)
Lou Montana
From a description note:
<unit> in <vehicle> literally does this: vehicle <unit> == <vehicle>. If <vehicle> is the same as <unit> the expression will return true for when the <unit> is on foot and false for when <unit> is in vehicle (see example 7 & 8).
Retrieved from "https://community.bistudio.com/wiki?title=in&oldid=321467"