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

<WRAP tabs>
  * [[4rpl:commands:GetUnitSpecifiedTarget|Get]]
  * [[4rpl:commands:SetUnitSpecifiedTarget|Set]]
  * [[4rpl:commands:ClearUnitSpecifiedTarget|Clear]]
</WRAP>

====== GetUnitSpecifiedTarget ======
GetUnitSpecifiedTarget(<-Unit) ->pos

===== Description =====
Pushes a unit's specified target to the stack. The specified target is a map cell location that is set either by the player or by script.
It typically shows up for units that allow a specified target to be set in their CPACK settings. When a unit allows this, it will show a target icon that follows
the mouse when selected.  The specified target is good for units that like to allow a player to specify where they should fire.
If there is no specified target, then -1,0,-1 is pushed to the stack.
The returned value is a vector consisting of three coordinates.  The map position is in the X and Z locations.  The Y value of the vector represents the terrain height at that map location.

===== Examples =====
<code 4rpl>
GetUnitSpecifiedTarget(self) ->pos
</code>
<=[[4rpl:start| Index]]