in: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(see also)
m (template:command argument fix)
(7 intermediate revisions by 4 users not shown)
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 37: Line 37:
|x4 = <code>_isInCar = [[player]] '''in''' car;</code>|=
|x4 = <code>_isInCar = [[player]] '''in''' car;</code>|=


|x5= Arma 3:<code>_isInside = [1000,2000,0] [[in]] myLocation;</code>|=
|x5= <code>_isInside = [1000,2000,0] [[in]] myLocation;</code>|=
|[[set]], [[resize]], [[reverse]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[find]], [[toArray]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]], [[inPolygon]] |= 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=


}}
}}
Line 55: Line 55:


<h3 style="display:none">Bottom Section</h3>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|INARRAY]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|INARRAY]]
[[Category:Scripting Commands OFP 1.46|INARRAY]]
[[Category:Scripting Commands ArmA|INARRAY]]
[[Category:Command_Group:_Variables|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
<!-- CONTINUE Notes -->
Line 69: Line 62:
<dd class="note">
<dd class="note">
As of Arma 3 1.26:
As of Arma 3 1.26:
<code>[0,0,0] in [[0,0,0],[1,4,3],[5,3,1]]; //returns '''true'''
<code>[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'''
[1,2,3] [[in]] [[1,2,3],[4,5,6]]; //returns '''true'''
</code>
</code>
Assuming it is now using comparison as found in [[isEqualTo]]
Assuming it is now using comparison as found in [[isEqualTo]]
</dd>
</dl>
<!-- DISCONTINUE Notes -->
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA]]
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Locations]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on August 27, 2017 - 11:33 (UTC)</dd>
<dt class="note">[[User:SilentSpike|SilentSpike]]</dt>
<dd class="note">
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:
<code>[[private]] _onFoot = _unit in _unit;</code>
</dd>
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->
<!-- DISCONTINUE Notes -->

Revision as of 15: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"