Inserting Rows into a Save Set

The mi_save_set_insert( ) function inserts a row into a save set.

To insert a new row into a save set

Obtain a row structure for the row you want to insert into the save set.
This row structure is usually the row that the mi_next_row( ) function retrieves from a cursor of a query.
Pass a pointer to this row structure to mi_save_set_insert( ).
Because a save set is a FIFO structure, mi_save_set_insert( ) appends the new row to the end of the save set.

If the insert is successful, the mi_save_set_insert( ) function returns a pointer to the row structure it just inserted.