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

save_set

is a pointer to an MI_SAVE_SET structure.

row

is 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

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 mi_save_set_create( ).

An MI_ROW pointer

is 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

indicates that the function was not successful.

See also the descriptions of mi_next_row( ) and mi_save_set_delete( ).