findNearestEnemy: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Comments" to "|Comments=")
(Updated SEE ALSO)
 
(48 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma |Game name=
|game1= arma1
|version1= 1.00


|1.00|Game version=
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Finds the nearest enemy to the specified position. Returns a null object if the object's group does not [[knowsAbout|know about]] any enemies. This command will return nearest object that is known to the unit and is considered enemy. An empty vehicle that is part of enemy group assets (see [[addVehicle]]) can be returned as valid nearest target.|DESCRIPTION=
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| object '''findNearestEnemy''' position |SYNTAX=
|game4= tkoh
|version4= 1.00


|p1= object: [[Object]]|PARAMETER1=
|game5= arma3
|version5= 0.50


|p2= position: [[Object]] or [[Array]] in format [[PositionAGL]] or [[Position2D]]|PARAMETER2=
|gr1= Object Detection


| [[Object]] |RETURNVALUE=
|descr= Finds the nearest enemy to the specified position. Returns a null object if the object's group does not [[knowsAbout|know about]] any enemies. This command will return nearest object that is known to the unit and is considered enemy. An empty vehicle that is part of enemy group assets (see [[addVehicle]]) can be returned as valid nearest target.
____________________________________________________________________________________________


|x1= <code>_myNearestEnemy = ([[units]] _myGroup [[select]] 0) [[findNearestEnemy]] [[player]];</code> |EXAMPLE1=
|s1= object [[findNearestEnemy]] position


|x2= <code>_myNearestEnemy = [[player]] [[findNearestEnemy]] [[player]];</code> |EXAMPLE2=
|p1= object: [[Object]]
____________________________________________________________________________________________


| [[nearestBuilding]], [[nearestObject]], [[nearestObjects]], [[nearObjects]], [[nearestLocation]], [[nearEntities]], [[nearTargets]], [[nearSupplies]], [[nearestLocationWithDubbing]], [[nearObjectsReady]], [[nearRoads]] |SEEALSO=
|p2= position: [[Object]] or [[Array]] in format [[Position#PositionAGL|PositionAGL]] or [[Position#Introduction|Position2D]]


}}
|r1= [[Object]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>_myNearestEnemy = (units _myGroup select 0) findNearestEnemy player;</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x2= <sqf>_myNearestEnemy = player findNearestEnemy player;</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[targets]] [[targetsQuery]] [[nearTargets]] [[targetsAggregate]] [[targetKnowledge]] [[knowsAbout]] [[reveal]] [[forgetTarget]] [[setTargetAge]] [[getHideFrom]] [[nearestBuilding]] [[nearestObject]] [[nearestObjects]] [[nearObjects]] [[nearestLocation]] [[nearEntities]] [[nearSupplies]] [[nearestLocationWithDubbing]] [[nearObjectsReady]] [[nearRoads]] [[nearestMines]]
[[Category:Scripting Commands|FINDNEARESTENEMY]]
}}
[[Category:Scripting Commands ArmA|FINDNEARESTENEMY]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 12:43, 7 September 2022

Hover & click on the images for description

Description

Description:
Finds the nearest enemy to the specified position. Returns a null object if the object's group does not know about any enemies. This command will return nearest object that is known to the unit and is considered enemy. An empty vehicle that is part of enemy group assets (see addVehicle) can be returned as valid nearest target.
Groups:
Object Detection

Syntax

Syntax:
object findNearestEnemy position
Parameters:
object: Object
position: Object or Array in format PositionAGL or Position2D
Return Value:
Object

Examples

Example 1:
_myNearestEnemy = (units _myGroup select 0) findNearestEnemy player;
Example 2:
_myNearestEnemy = player findNearestEnemy player;

Additional Information

See also:
targets targetsQuery nearTargets targetsAggregate targetKnowledge knowsAbout reveal forgetTarget setTargetAge getHideFrom nearestBuilding nearestObject nearestObjects nearObjects nearestLocation nearEntities nearSupplies nearestLocationWithDubbing nearObjectsReady nearRoads nearestMines

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