 | |  |  |  |  |
| | | | | |
mcATcreateTable — Create array table
#include <memcom.h>
int mcATcreateTable(int handle, const char* name,
mcOff nrows, const char* colspec);mcATcreateTable creates an array table
name on the database identified by
handle. The table contains
nrows rows and columns defined by the string
colnames (see below). If completed successfully,
the function returns 0. Otherwise, a negative value indicating the
MemCom error number is returned.
handleDatabase handle (input).
nameName of a new dataset defining the array table (input).
nrowsNumber of rows of array table (input). In the present version the number of rows cannot be modified once defined by this function.
colspecColumn name ands type specification of array table
(input). The string must be of the form
"colspec1.colspec2. etc", i.e the column
name specifications must be separated by the period
character. Thus, the specification of
colspec also defines the number of
columns in the table. Each column name is of the form
"name:type", where
name is the column name and
type the data type of the column. The
column name is a string of less than
MC_AT_COL_NAME_SIZE characters. The data
type must be of the form nF, where
n is the number of data elements and
F the data type. n is
either a positive integer or *,meaning
that the number of data elements is variable for each row of
the column. F must be one of: F
(mcFloat64), E (mcFloat32),
Z (mcComplexFloat64),
C (mcComplexFloat32),
J (mcInt64), I
(mcInt32), K (array of characters). In
the present version the number of columns cannot be modified
once defined by this function.