MemCom Reference Manual > MemCom C API Manual Pages > Sparse Table Functions > mcSTcellGetArray

Name

mcSTcellGetArray — Copy the cell data into a buffer

Synopsis

#include <memcom.h>

int mcSTcellGetArray(int dsid, int row_index, mcInt64 column_index, void* data);

Description

mcSTcellGetArray copies, for sparse-table dataset identified by dsid, the data of the non-empty cell identified by the row row_index and the column index column_index to the buffer pointed to by data.

Parameters

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.

data (input)

Pointer to a buffer in memory which is large enough to hold the cell data. The required buffer size can be determined by calling mcSTcellSize.

Return Value

If no error occurred, 0 is returned. Otherwise, a negative value indicating the MemCom error number is returned.

See Also

mcSTcellGet

mcSTcellGetCopy

mcSTcellNumElements

mcSTcellSize