mi_integer
mi_tab_nextrow(MI_AM_TABLE_DESC  *tableDesc, 
   MI_ROW **row, 
   mi_integer *rowid, 
   mi_integer *fragid) 

tableDesc

points to the index descriptor.

row

points to the address of a row structure. The row structure contains the index entry that the access method reformats, if necessary, and inserts into the virtual index.

rowid

points to the row identifier of the associated table row.

fragid

points to the fragment identifier of the associated table row.

Use this function from the am_insert purpose function if am_insert can insert more than one new index entry. The values in row, rowid, and fragid replace the new row and row-ID descriptor that the database server passes to am_insert if shared memory holds only one new index entry.

The mi_tab_nextrow() function works together with the following related accessor functions:

• The mi_tab_setniorows() function sets a number of rows to pass to am_insert.
• The mi_tab_niorows() function gets the number of rows to expect.

For an example of how these three functions work together, refer to Figure 8.

The return value increments for each call to am_insert. The first call to mi_tab_nextrow() returns 0, the second returns 1, and so forth. A negative return value indicates an error.

See the descriptions of:

• Purpose function am_insert
• Accessor functions mi_tab_setniorows() and mi_tab_niorows()
• Building New Indexes Efficiently