in: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
Line 7: Line 7:
____________________________________________________________________________________________
____________________________________________________________________________________________


| Checks whether value is in array, unit in vehicle or position inside location. In case of value in array check, [[String]] values will be compared on CaSEseNsiTIve basis (see Example 2). Note: In Arma 2 you can not test for arrays within arrays using this command. |= Description
| Checks whether value is in array, unit in vehicle or position inside location. In case of value in array check, [[String]] values will be compared on CaSEseNsiTIve basis (see Example 2). Note: In Arma 2 you can not test for arrays within arrays using this command. |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| value '''in''' array |= Syntax
| value '''in''' array |SYNTAX=
|p1 = value: [[Anything]] - any value (Arma 2 cannot  match [[Array]])
|p1 = value: [[Anything]] - any value (Arma 2 cannot  match [[Array]])
|p2 = array: [[Array]] - array of values
|p2 = array: [[Array]] - array of values
| [[Boolean]] |= Return value
| [[Boolean]] |RETURNVALUE=


| s2= unit '''in''' vehicle |= Syntax
| s2= unit '''in''' vehicle |SYNTAX=
|p21 = unit: [[Object]] - person
|p21 = unit: [[Object]] - person
|p22 = vehicle: [[Object]] - transport
|p22 = vehicle: [[Object]] - transport


|r2= [[Boolean]] |= Return value
|r2= [[Boolean]] |RETURNVALUE=


| s3=position '''in''' location |= Syntax       (''available since Arma 3'')
| s3=position '''in''' location |SYNTAX=       (''available since Arma 3'')


|p41= position: [[Array]] - format [[Position2D]] or [[Position3D]] |= Parameter 1
|p41= position: [[Array]] - format [[Position2D]] or [[Position3D]] |PARAMETER1=
|p42= location: [[Location]] |= Parameter 2
|p42= location: [[Location]] |PARAMETER2=


| r3=[[Boolean]] |= Return value
| r3=[[Boolean]] |RETURNVALUE=
____________________________________________________________________________________________
____________________________________________________________________________________________
|x1 = <code>1 [[in]] [0,1,2]; //true</code>|=
|x1 = <code>1 [[in]] [0,1,2]; //true</code>|=
Line 38: Line 38:


|x5= <code>_isInside = [1000,2000,0] [[in]] myLocation;</code>|=
|x5= <code>_isInside = [1000,2000,0] [[in]] myLocation;</code>|=
|[[inPolygon]], [[inArea]], [[set]], [[resize]], [[reverse]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[find]], [[toArray]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]]|= See also
|[[inPolygon]], [[inArea]], [[set]], [[resize]], [[reverse]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[find]], [[toArray]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]]|SEEALSO=


}}
}}

Revision as of 14:41, 7 April 2019

Logo A0.png1.00
Hover & click on the images for description

Description

Description:
Checks whether value is in array, unit in vehicle or position inside location. In case of value in array check, String values will be compared on CaSEseNsiTIve basis (see Example 2). Note: In Arma 2 you can not test for arrays within arrays using this command.
Groups:
Uncategorised

Syntax 1

Syntax:
value in array
Parameters:
value: Anything - any value (Arma 2 cannot match Array)
array: Array - array of values
Return Value:
Boolean

Syntax 2

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

Syntax 3

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

Examples

Example 1:
1 in [0,1,2]; //true
Example 2:
"lol" in ["Lol", "LOL", "loL"]; //false "loL" in ["Lol", "LOL", "loL"]; //true
Example 3:
Arma 3:[1,2,3] in [[1,2,3],[4,5,6]]; //true
Example 4:
_isInCar = player in car;
Example 5:
_isInside = [1000,2000,0] in myLocation;

Additional Information

See also:
inPolygoninAreasetresizereversepushBackpushBackUniqueapplyselectfindtoArraytoStringforEachcountdeleteAtdeleteRangeappendsortparamparamsarrayIntersectsplitStringjoinString

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 15:58, 18 January 2007 (CET)
T_D
For a case-insensitive test use count: {_x == "lol"} count ["Lol", "LOL", "loL"]; //returns 3. Checking if an array (for example a position) is in another array doesn't produce an error, but it will always return false. e.g. [0,0,0] in [[0,0,0],[1,4,3],[5,3,1]]; //returns: false.

Bottom Section

Posted on August 23, 2014 - 10:10 (UTC)
PabstMirror
As of Arma 3 1.26: [0,0,0] in [[0,0,0],[1,4,3],[5,3,1]]; //returns true [1,2,3] in [[1,2,3],[4,5,6]]; //returns true Assuming it is now using comparison as found in isEqualTo
Posted on August 27, 2017 - 11:33 (UTC)
SilentSpike
The Object syntax of in might not behave as you'd expect (e.g. it would always return true) when both parameters are the same object . It serves as a quick method of checking if a unit is mounted: private _onFoot = _unit in _unit;
Retrieved from "https://community.bistudio.com/wiki?title=in&oldid=121816"