Next: Data Type Specific List Functions, Previous: List Item Range Functions, Up: The List Library [Index]
Position range functions operate on list elements between two (insert) positions.
The end positions are further identified as p (head or first given position) and r (tail or second given position).
If r indicates an position prior to p the elements between p and the end of the list and those from the beginning of the list to r are operated (as if the list was circular).
list l_purge(list l, integer p, integer r);
is l, deletes the elements of the l list between the p and r positions
list lr_clear(list l, integer p, integer r);
same as ‘l_purge’
object lr_xcall(list l, object o, integer i, integer p, integer r, &...);
is the evaluation result of the function indicated by o called with the unnamed arguments and the elements of the l list between the p and r positions inserted at the position i in between the unnamed arguments.
The variadic arguments are passed by reference where possible.