The mi_save_set_insert() function inserts
a row into a save set.
About this task
To insert a new row into a save set:
Procedure
- 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.
Results
If the insert is successful, the mi_save_set_insert() function
returns a pointer to the row structure it just inserted.