HP (Hewlett-Packard) HP OpenView Vantagepoint – Operation Manual for UNIX User Manual

Page of 326
Using the VPO Application Programming Interfaces
Summary of VPO API Functions
Chapter 4
194
Functions of the VPO Iterator
See the man page opciter(3) for more information about these functions.
Table 4-4
Overview of the Iterator Functions
Function Call
Description
opciter_begin()
Sets the iterator to the first element and returns its
pointer.
opciter_create()
Creates an iterator
opciter_end()
Returns past-end-value (== NULL)
opciter_free()
Frees memory of the iterator
opciter_get_pos()
Returns actual position of the iterator
opciter_next()
Returns pointer to the next container element and
increments the iterator
opciter_nth()
Returns pointer to the element on the nth position.
The iterator remains unchanged
opciter_prev()
Returns pointer to the previous container element
and decrements the iterator
opciter_set_pos()
Sets iterator to specified position