in

1.001.001.001.001.501.000.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

0.50

Syntax 3

Syntax:

position in location

Parameters:

position: Array - format Position2D or Position3D

location: Location

Return Value:

Boolean

1.96

Syntax 4

Syntax:

needle in haystack

Parameters:

needle: String - string to search for

haystack: String - string to search in

Return Value:

Boolean

2.02

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 2019-10-08 - 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).