Returns the current index of a SCAN or ARRAY. That
is the number of valid points. Total() returns the upper limit.
Normally the current index is equal to total().
There are operations, like CUT and KEEP for example, which
create SCANs with smaller current indices.
This function
can also be used to set the current index.