MemCom Reference Manual > MemCom C API Manual Pages > Array Table Functions > mcATputCell

Name

mcATputCell — Insert data in cell of array table

Synopsis

#include <memcom.h>

int mcATputCell(int handle, const char* name,
                mcOff row, mcOff col, mcOff lbuffer, void* buffer);

Description

mcATputCell inserts lbuffer data elements from buffer in the cell described by row, col of the array table name residing on the database handle. If completed successfully, the function returns 0. Otherwise, a negative value indicating the MemCom error number is returned.

Parameters

handle

Database handle (input).

name

Name of a new dataset defining the array table (input).

row

Row of array table where data is inserted (input). row must be greater or equal to 1 and less or equal to the number of defined rows.

col

Column number (not name) of array table where data is inserted (input). col must be greater or equal to 1 and less or equal to the number of defined columns.

lbuffer

Number of data elements of buffer to be inserted in array table (input).

buffer

Buffer containing data elements to be inserted in array table (input). The data type must correspond to the data type specified for the column col.