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

Name

mcSTcolFind — Lookup sparse-table columns by name

Synopsis

#include <memcom.h>

mcInt64 mcSTcolFind(int dsid, const char* name);

Description

mcSTcolFind attempts to find, for the sparse-table dataset identified by dsid, the index of the column whose name matches name. Column indices start at 1.

Parameters

dsid (input)

Dataset identifier.

name (input)

Pointer to a NUL-terminated character string containing the name of the column to be looked up.

Return Value

If a column, whose name matches the argument name, could be found, the index (starting from 1) of that column is returned. If no such column could be found, 0 is returned. If an error occurred, a negative value indicating the MemCom error number is returned.

See Also

mcSTdatasetClear, mcSTcolAppend, mcSTcolNum