in: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| ofp |Game name=
| ofp


|1.00|Game version=
|1.00


|gr1= Strings |GROUP1=
|gr1= Strings


|gr2= Arrays |GROUP2=
|gr2= Arrays


|gr3= Locations |GROUP3=
|gr3= Locations


|gr4= HashMap |GROUP4=
|gr4= HashMap


|gr5= Unit Control |GROUP5=
|gr5= Unit Control


| 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]].
| 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]].
{{Informative | [[String]] comparison is case-sensitive (see Examples '''2''' and '''6''').}}
{{Informative | [[String]] comparison is case-sensitive (see Examples '''2''' and '''6''').}}
{{Feature|arma3 | Since {{arma3}} you can test for arrays within arrays.}} |DESCRIPTION=
{{Feature|arma3 | Since {{arma3}} you can test for arrays within arrays.}}


| value [[in]] array |SYNTAX=
| value [[in]] array


|p1= value: [[Anything]] - any value (cannot  match [[Array]] before {{arma3}}) |PARAM1=
|p1= value: [[Anything]] - any value (cannot  match [[Array]] before {{arma3}}) |PARAM1=
Line 25: Line 25:
|p2= array: [[Array]] - array of values |PARAM2=
|p2= array: [[Array]] - array of values |PARAM2=


| [[Boolean]] |RETURNVALUE=
| [[Boolean]]


|s2= unit [[in]] vehicle |SYNTAX2=
|s2= unit [[in]] vehicle


|p21 = unit: [[Object]] - entity person |PARAM21=
|p21 = unit: [[Object]] - entity person |PARAM21=
Line 33: Line 33:
|p22 = vehicle: [[Object]] - entity vehicle |PARAM22=
|p22 = vehicle: [[Object]] - entity vehicle |PARAM22=


|r2= [[Boolean]] |RETURNVALUE2=
|r2= [[Boolean]]


|s3= position [[in]] location {{Since|arma3||y}} |SYNTAX3=
|s3= position [[in]] location {{Since|arma3||y}}


|p41= position: [[Array]] - format [[Position2D]] or [[Position3D]]|PARAM41=
|p41= position: [[Array]] - format [[Position2D]] or [[Position3D]]|PARAM41=
Line 41: Line 41:
|p42= location: [[Location]] |PARAM42=
|p42= location: [[Location]] |PARAM42=


|r3= [[Boolean]] |RETURNVALUE3=
|r3= [[Boolean]]


|s4= needle [[in]] haystack {{Since|arma3|1.95.146032|y}} |SYNTAX4=
|s4= needle [[in]] haystack {{Since|arma3|1.95.146032|y}}


|p61= needle: [[String]] - string to search for |PARAM61=
|p61= needle: [[String]] - string to search for |PARAM61=
Line 49: Line 49:
|p62= haystack: [[String]] - string to search in |PARAM62=
|p62= haystack: [[String]] - string to search in |PARAM62=


|r4= [[Boolean]] |RETURNVALUE4=
|r4= [[Boolean]]


|s5= key [[in]] hashMap |SYNTAX5=
|s5= key [[in]] hashMap


|p81= key: [[HashMapKey]] |PARAM81=
|p81= key: [[HashMapKey]] |PARAM81=
Line 57: Line 57:
|p82= hashMap : [[HashMap]] |PARAM82=
|p82= hashMap : [[HashMap]] |PARAM82=


|r5= [[Boolean]] |RETURNVALUE5=
|r5= [[Boolean]]


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


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


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


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


|x4= <code>_isInCar = [[player]] [[in]] car;</code> |Example4=
|x4= <code>_isInCar = [[player]] [[in]] car;</code>


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


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


|x7= <code>[[private]] _boarded = [[player]] [[in]] _groupVehicle;</code> |Example7=
|x7= <code>[[private]] _boarded = [[player]] [[in]] _groupVehicle;</code>


|x8= <code>[[private]] _onFoot = _unit [[in]] _unit;
|x8= <code>[[private]] _onFoot = _unit [[in]] _unit;
{{cc|[[vehicle]] _unit {{=}}{{=}} _unit works}}
{{cc|[[vehicle]] _unit {{=}}{{=}} _unit works}}
{{cc|[[isNull]] [[objectParent]] _unit is even faster}}</code> |Example8=
{{cc|[[isNull]] [[objectParent]] _unit is even faster}}</code>


|[[inPolygon]], [[inArea]], [[set]], [[resize]], [[reverse]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[find]], [[toArray]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]], [[forceUnicode]] |SEEALSO=
|[[inPolygon]], [[inArea]], [[set]], [[resize]], [[reverse]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[find]], [[toArray]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]], [[forceUnicode]]
}}
}}


Revision as of 00:41, 18 January 2021

Logo A0.png1.00
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).
Arma 3
Since Arma 3 you can test for arrays within arrays.
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 Template:Since
Parameters:
position: Array - format Position2D or Position3D
location: Location
Return Value:
Boolean

Syntax 4

Syntax:
needle in haystack Template:Since
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 findIf { 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:
_isInCar = player in car;
Example 5:
_isInside = [1000,2000,0] in myLocation;
Example 6:
_isInString = "foo" in "foobar"; // true _isInString = "Foo" in "foobar"; // false
Example 7:
private _boarded = player in _groupVehicle;
Example 8:
private _onFoot = _unit in _unit; // vehicle _unit == _unit works // isNull objectParent _unit is even faster

Additional Information

See also:
inPolygoninAreasetresizereversepushBackpushBackUniqueapplyselectfindtoArraytoStringforEachcountdeleteAtdeleteRangeappendsortparamparamsarrayIntersectsplitStringjoinStringforceUnicode

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

Notes

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

Bottom Section

Retrieved from "https://community.bistudio.com/wiki?title=in&oldid=204990"