QMReadNext() |
![]() ![]() ![]() |
The QMReadNext() function retrieves the next entry from a select list
Format
where
The QMReadNext() function retrieves the next entry from the select list identified by the ListNo argument.
If successful, the function returns the list entry and, in the Visual Basic API, Errno is set to SV_OK.
If the list is empty, the Visual Basic API function returns a null string and Errno is set to SV_ELSE. In the C API implementation, the function returns NULL.
See also the QMReadList() function for a discussion of the relationship between QMReadNext() and QMReadList().
Note that in the C API library, the returned string is dynamically allocated. A loop containing a call to this function must free the memory from each call separately. |