~~NOTOC~~
<=[[4rpl:start| Index]]

:!: Available in version 1.3 and later.
====== GetNearestSpecialTarget======
GetNearestSpecialTarget(<-specialTarget <-worldPosition <-range <-includeIsBuilding) ->unit

===== Description =====
Finds the nearest unit that is tagged as a special target within range (a float) from worldPosition (a vector3). The 'specialTarget' argument is a V4 that specifies the target types. See [[GetUnitSpecialTarget]].

If no unit matching the special target parameter is found, -1 is returned.

:NOTE: For clarification: Line Of Sight is not factored. If you want to use this API with LOS restrictions, see [[4rpl:commands:getterrainlos|GetTerrainLOS]].\\
:WARNING: Spores, Blobs, etc, aren't special targets and will not be detected.
            
===== Examples =====
<code 4rpl>
GetNearestSpecialTarget(V4(1 1 0 0) GetUnitPosition(self) GetUnitRange(self) false) ->unit
</code>

<=[[4rpl:start| Index]]