 | |  |  |  |  |
| | | | | |
mcSTcellFindNext — Get the next non-empty sparse-table cell
#include <memcom.h> mcInt64 mcSTcellFindNext(int dsid, int row_index, mcInt64 column_index);
mcSTcellFindNext attempts to find, for
the sparse-table dataset identified by dsid, the
next non-empty cell, relative to the non-empty cell identified by
the row index row_index and the column index
column_index.
Using mcSTcellFindNext, one can
efficiently iterate over all non-empty cells of a row.
Cells are in general not sorted inside a row (see mcSTrowSort). For unsorted rows,
the column indices returned by mcSTcellFindNext
are in the order by which the cells were added to the row.
dsid (input)Dataset identifier.
row_index (input)Index of the row, starting at 1.
column_index (input)Index of the column whose next non-empty cell is requested. Column indices start at 1. The column index must either be 0 or refer to a non-empty cell. If 0 is given, the first non-empty cell is requested.