 | |  |  |  |  |
| | | | | |
mcSTcellSet — Set the cell data
#include <memcom.h>
int mcSTcellSet(int dsid, int row_index, mcInt64 column_index,
mcInt64 num_elements, const void* data);mcSTcellSet copies, for the sparse-table
dataset identified by dsid, and for the cell
identified by the row index row_index and the
column index column_index, the data from the
buffer pointed to by data, to the cell's internal
in-memory buffer.
mcSTcellSet can be used for all column
data types except "K" (character strings). For the latter, use mcSTcellSetK
instead.
mcSTcellSet renders previously empty
cells non-empty. In this case, the row's sorting order will not be
maintained for reasons of computational efficiency. To sort the
non-empty cells inside the a row, use mcSTrowSort.
To empty a cell, use mcSTcellClear.
dsid (input)Dataset identifier.
row_index (input)Index of the row, starting at 1.
column_index (input)Index of the column whose data is requested. Column indices start at 1.
num_elements (input)The number of elements of the cell. For fixed-sized columns, this parameter must match the column's num_elements attribute.
data (input)Pointer to a buffer in memory containing the new cell
data. The element data type must match the column's data
type. The size of the buffer in bytes must be
num_elements * mcSizeof(type),
where type is the column's data
type.