Difference between revisions of "in"

From Bohemia Interactive Community
Jump to navigation Jump to search
m
m (template:command argument fix)
(8 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]] |= 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

Introduced with Operation Flashpoint version 1.00
  

Click on the images for descriptions

Introduced in

Game:
Operation Flashpoint
Version:
1.00

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.

Syntax

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

Alternative Syntax

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

Alternative Syntax 2

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

Multiplayer:
-
See also:
inPolygoninAreasetresizereversepushBackpushBackUniqueapplyselectfindtoArraytoStringforEachcountdeleteAtdeleteRangeappendsortparamparamsarrayIntersectsplitStringjoinString

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

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;