Inserting rows into a save set
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.