currentWaypoint: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
m (Some wiki formatting)
 
(2 intermediate revisions by the same user not shown)
Line 15: Line 15:
|gr1= Waypoints
|gr1= Waypoints


|descr= Returns the '''index''' of the current waypoint contrary to misleading name.
|descr= Returns the ''index'' of the current waypoint ('''not''' the waypoint in [[Waypoint|Waypoint Array]] format).


To determine the validity of the index, compare it to the waypoints count.
* To determine the validity of the index, compare it to the waypoints count.
* If all waypoints are completed, then the index is 1 greater than the last valid index.
* If there are no waypoints, then the index is 0.


If all waypoints are completed, then the index is 1 greater than the last valid index.
By default, a group has one already-completed waypoint at their starting position, making the first waypoint number one, not zero.


If there are no waypoints, then the index is 0.
|s1= [[currentWaypoint]] groupName
 
By default, a group has 1 waypoint at their starting position, which is considered completed and so the currentWaypoint is 1.
 
|s1= [[currentWaypoint]] groupName


|p1= groupName: [[Group]]
|p1= groupName: [[Group]]


|r1= [[Number]] - The index of current waypoint
|r1= [[Number]] - index of the current waypoint


|x1= <sqf>_index = currentWaypoint group player;</sqf>
|x1= <sqf>_index = currentWaypoint group player;</sqf>
|x2= <sqf>_waypointFormat = [_group, currentWaypoint _group];</sqf>


|seealso= [[waypoints]] [[setCurrentWaypoint]]
|seealso= [[waypoints]] [[setCurrentWaypoint]]
}}
}}

Latest revision as of 22:40, 22 February 2026

Hover & click on the images for description

Description

Description:
Returns the index of the current waypoint (not the waypoint in Waypoint Array format).
  • To determine the validity of the index, compare it to the waypoints count.
  • If all waypoints are completed, then the index is 1 greater than the last valid index.
  • If there are no waypoints, then the index is 0.
By default, a group has one already-completed waypoint at their starting position, making the first waypoint number one, not zero.
Groups:
Waypoints

Syntax

Syntax:
currentWaypoint groupName
Parameters:
groupName: Group
Return Value:
Number - index of the current waypoint

Examples

Example 1:
_index = currentWaypoint group player;
Example 2:
_waypointFormat = [_group, currentWaypoint _group];

Additional Information

See also:
waypoints setCurrentWaypoint

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note