Difference between revisions of "in"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (…Fix the fix)
 
(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
'''in''' can refer to these scripting commands:
+
{{Command|Comments=
*[[in vehicle]] - Checks whether the soldier is mounted in the vehicle.
+
____________________________________________________________________________________________
*[[in Array]] - Checks whether x is equal to any element in the array.
 
*[[in location]] - Checks whether a position is within a location's area.
 
  
 +
| ofp |Game name=
  
 +
|1.00|Game version=
 +
____________________________________________________________________________________________
  
{{Disambig}}
+
| Checks whether value is in array, unit is in vehicle, position is inside location or string is part of other string.
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
+
{{Informative | [[String]] comparison is case-sensitive (see Examples '''2''' and '''6''').}}
 +
{{Feature arma3 | Since {{arma3}} you can test for arrays within arrays.}} |DESCRIPTION=
 +
____________________________________________________________________________________________
 +
 
 +
| value [[in]] array |SYNTAX=
 +
 
 +
|p1= value: [[Anything]] - any value (cannot  match [[Array]] before {{arma3}}) |PARAM1=
 +
 
 +
|p2= array: [[Array]] - array of values |PARAM2=
 +
 
 +
| [[Boolean]] |RETURNVALUE=
 +
____________________________________________________________________________________________
 +
 
 +
|s2= unit [[in]] vehicle |SYNTAX2=
 +
 
 +
|p21 = unit: [[Object]] - entity person |PARAM21=
 +
 
 +
|p22 = vehicle: [[Object]] - entity vehicle |PARAM22=
 +
 
 +
|r2= [[Boolean]] |RETURNVALUE2=
 +
____________________________________________________________________________________________
 +
 
 +
|s3= position [[in]] location        (''Since {{arma3}}'')|SYNTAX3=
 +
 
 +
|p41= position: [[Array]] - format [[Position2D]] or [[Position3D]]|PARAM41=
 +
 
 +
|p42= location: [[Location]] |PARAM42=
 +
 
 +
|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=
 +
____________________________________________________________________________________________
 +
 
 +
|x1= <code>1 [[in]] [0, 1, 2]; {{cc|true}}</code> |Example 1=
 +
 
 +
|x2= <code>[[private]] _myArray = ["Aaa", "AAa", "AAA"];
 +
 
 +
"aaa" [[in]] _myArray; {{cc|false}}
 +
"AAa" [[in]] _myArray; {{cc|true}}
 +
 
 +
{{cc|case-insensitive alternatives}}
 +
_myArray [[findIf]] { _x == "aaa"; } != -1; {{cc|true}}
 +
 
 +
({
 +
[[if]] ([[_x]] == "aaa") [[exitWith]] { [[_forEachIndex]] };
 +
-1
 +
} [[forEach]] _myArray) != -1; {{cc|true, less performant but valid before [[findIf]]}}
 +
 
 +
{ [[if]] ([[_x]] == "aaa") [[exitWith]] {1} } [[count]] _myArray > 0; {{cc|true}}
 +
 
 +
{ [[_x]] == "aaa"; } [[count]] _myArray > 0; {{cc|true, worst performance}}
 +
{{cc|only option available in OFP}}</code> |Example2=
 +
 
 +
|x3= Arma 3:<code>[1,2,3] [[in]] <nowiki>[</nowiki>[1,2,3], [4,5,6]]; {{cc|true}}</code> |Example3=
 +
 
 +
|x4= <code>_isInCar = [[player]] [[in]] car;</code> |Example4=
 +
 
 +
|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=
 +
 
 +
|x7= <code>[[private]] _boarded = [[player]] [[in]] _groupVehicle;</code> |Example7=
 +
 
 +
|x8= <code>[[private]] _onFoot = _unit [[in]] _unit;
 +
{{cc|[[vehicle]] _unit {{=}}{{=}} _unit works}}
 +
{{cc|[[isNull]] [[objectParent]] _unit is even faster}}</code> |Example8=
 +
 
 +
|[[inPolygon]], [[inArea]], [[set]], [[resize]], [[reverse]], [[pushBack]], [[pushBackUnique]], [[apply]], [[select]], [[find]], [[toArray]], [[toString]], [[forEach]], [[count]], [[deleteAt]], [[deleteRange]], [[append]], [[sort]], [[param]], [[params]], [[arrayIntersect]], [[splitString]], [[joinString]]|SEEALSO=
 +
}}
 +
 
 +
<h3 style="display:none">Notes</h3>
 +
<dl class="command_description">
 +
<!-- Note Section BEGIN -->
 +
 
 +
<dd class="notedate">Posted on October 8, 2019 - 21:08 (UTC)</dd>
 +
<dt class="note">[[User:Lou Montana|Lou Montana]]</dt>
 +
<dd class="note">''From a description note:''<br>
 +
''<unit>'' [[in]] ''<vehicle>'' literally does this: <tt>[[vehicle]] <unit> <nowiki>==</nowiki> <vehicle></tt>. 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''' &amp; '''8''').
 +
</dd>
 +
 
 +
<!-- Note Section END -->
 +
</dl>
 +
 
 +
<h3 style="display:none">Bottom Section</h3>
 +
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands ArmA]]
 +
[[Category:Scripting Commands ArmA2]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Command_Group:_Locations]]

Latest revision as of 23:19, 8 October 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 is in vehicle, position is inside location or string is part of other string.
String comparison is case-sensitive (see Examples 2 and 6).
Arma 3 logo black.png
Since Arma 3 you can test for arrays within arrays.

Syntax

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

Alternative Syntax

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

Alternative Syntax 2

Syntax:
position in location        (Since Arma 3)
Parameters:
position: Array - format Position2D or Position3D
location: Location
Return Value:
Boolean

Alternative Syntax 3

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 ({ 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:
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
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

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