in: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(string in string)
Line 7: Line 7:
____________________________________________________________________________________________
____________________________________________________________________________________________


| Checks whether value is in array, unit in vehicle or position inside location.
| Checks whether value is in array, unit is in vehicle, position is inside location or string is part of other string.
{{Informative | [[String]] value [[in]] array check will be compared on a case-sensitive basis (see Example 2).}}
{{Informative | [[String]] comparison case-sensitive (see Examples 2, 5).}}
{{Feature arma3 | Since {{arma3}} you can test for arrays within arrays.}} |DESCRIPTION=
{{Feature arma3 | Since {{arma3}} you can test for arrays within arrays.}} |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________
Line 14: Line 14:
| 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]]) |PARAM1=


|p2= array: [[Array]] - array of values
|p2= array: [[Array]] - array of values |PARAM2=


| [[Boolean]] |RETURNVALUE=
| [[Boolean]] |RETURNVALUE=
Line 23: Line 23:
|s2= unit [[in]] vehicle |SYNTAX2=
|s2= unit [[in]] vehicle |SYNTAX2=


|p21 = unit: [[Object]] - person
|p21 = unit: [[Object]] - person |PARAM21=


|p22 = vehicle: [[Object]] - transport
|p22 = vehicle: [[Object]] - transport|PARAM22=


|r2= [[Boolean]] |RETURNVALUE2=
|r2= [[Boolean]] |RETURNVALUE2=
Line 32: Line 32:
|s3= position [[in]] location        (''Since {{arma3}}'')|SYNTAX3=
|s3= position [[in]] location        (''Since {{arma3}}'')|SYNTAX3=


|p31= position: [[Array]] - format [[Position2D]] or [[Position3D]]
|p41= position: [[Array]] - format [[Position2D]] or [[Position3D]]|PARAM41=


|p32= location: [[Location]]
|p42= location: [[Location]] |PARAM42=


|r3= [[Boolean]] |RETURNVALUE3=
|r3= [[Boolean]] |RETURNVALUE3=
____________________________________________________________________________________________
|s4= needle [[in]] haystack        (''Since {{arma3}} v1.95.146032'')|SYNTAX4=
|p61= needle: [[String]] - string to search for |PARAM61=
|p62= haystack: [[String]] - string to search in |PARAM62=
|r4= [[Boolean]] |RETURNVALUE4=
____________________________________________________________________________________________
____________________________________________________________________________________________


Line 54: Line 63:
|x4= <code>_isInCar = [[player]] [[in]] car;</code> |Example4=
|x4= <code>_isInCar = [[player]] [[in]] car;</code> |Example4=


|x5= <code>_isInside = [1000,2000,0] [[in]] myLocation;</code>|Example5=
|x5= <code>_isInside = [1000,2000,0] [[in]] myLocation;</code>|Example5=
 
|x6= <code>_isInString = "foo" [[in]] "foobar"; {{cc|true}}
_isInString = "Foo" [[in]] "foobar"; {{cc|false}}</code>|Example6=


|[[inPolygon]], [[inArea]], [[set]], [[resize]], [[reverse]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[find]], [[toArray]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]]|SEEALSO=
|[[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 17:22, 4 September 2019

Hover & click on the images for description

Description

Description:
Checks whether value is in array, unit is in vehicle, position is inside location or string is part of other string.
String comparison case-sensitive (see Examples 2, 5).
Arma 3
Since Arma 3 you can test for arrays within arrays.
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        (Since Arma 3)
Parameters:
position: Array - format Position2D or Position3D
location: Location
Return Value:
Boolean

Syntax 4

Syntax:
needle in haystack        (Since Arma 3 v1.95.146032)
Parameters:
needle: String - string to search for
haystack: String - string to search in
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 _x count _myArray > 0; // true, less performant but valid before findIf
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;
Example 6:
_isInString = "foo" in "foobar"; // true _isInString = "Foo" in "foobar"; // false

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 August 27, 2017 - 11:33 (UTC)
SilentSpike
The Object syntax of in might not behave as you would 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;

Bottom Section