INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_save_set_get_next()

The mi_save_set_get_next() function is used to traverse a save set in the forward direction.

Syntax

Usage

DataBlade API maintains a save set as an FIFO (first-in, first-out) queue.

Return Values

On success, returns a pointer to the next row forward in the specified save set.

Returns NULL and sets *error to 0 if the save set is empty or has been completely traversed.

Returns NULL and sets *error to MI_ERROR on failure.

Related Topics

For additional information, see the descriptions of the following functions: mi_save_set_get_first(), mi_save_set_get_last(), and mi_save_set_get_previous().




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.