Oma_Ov_Reader_Iterator_Forward()
Abstract
Advances an iterator to the next matching vector.
Syntax
Oma_Ov_Reader_Iterator_Forward (iterator)
| Argument | Type | Description |
|---|---|---|
iterator |
OmaT_Ov_Reader_Iterator * |
Iterator of interest. |
Return Type
int
PRGC_TRUE if another matching vector exists; PRGC_FALSE otherwise.
Header
oma_ov.h
Details
This function reads the next vector that matches the search criteria specified when the iterator was created. If there are no more matching vectors, it returns PRGC_FALSE. Otherwise, PRGC_TRUE is returned. This lets you easily iterate over the vectors in a file with code similar to the following:
while (Oma_Ov_Reader_Iterator_Forward (iterator) == PRGC_TRUE)
{
...
}
This function should be called at least once before calling Oma_Ov_Reader_Iterator_Vector_Get() to retrieve the actual vector.