The mi_save_set_insert() function

The mi_save_set_insert() function appends a copy of a row to the end of a save set.

Syntax

MI_ROW *mi_save_set_insert(save_set, row)
   MI_SAVE_SET *save_set;
   MI_ROW *row;

save_set: A pointer to an MI_SAVE_SET structure.
row: A pointer to a row that, typically, a call to mi_next_row() fetches from the database server.

Valid in client LIBMI application?	Valid in user-defined routine?
Yes	Yes

Usage

The mi_save_set_insert() function inserts a row into the save set that save_set references. Because the DataBlade API maintains a save set as an FIFO (first-in, first-out) queue, mi_save_set_insert() appends the new row to the end of the save set. This save set must have been previously created with the mi_save_set_create() function.

Return values

An MI_ROW pointer: A pointer to the copy of row that is being appended to the save set. The application can use this pointer to access the row.
NULL: The function was not successful.