Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

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

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 into which a new row is inserted.
row	is a pointer to the row that is inserted. It is typically fetched from the database server by a call to mi_next_row().

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

See the descriptions of the following functions: mi_next_row() and mi_save_set_delete().