MemCom Reference Manual > MemCom C API Manual Pages > Database Manager Functions > mcDBcreateSet

Name

mcDBcreateSet — Create dataset on database

Synopsis

#include <memcom.h>

int mcDBcreateSet(int handle, const char* name, const char* type,
                  int ndim, mcOff* dim);

Description

mcDBresSet creates a dataset on database identified by handle. The contents of the set remain undefined until the set is written to the database.

The function returns the status code. If completed successfully, the function returns 0. Otherwise, a negative value indicating the MemCom error number is returned.

Warning: It is recommended to initialize sets with mcDBinitSet, since reading sets which have not been initialized can lead to problems, especially with K sets, where the NULL terminator is not defined! K sets must be initialized with the 0 character.

Parameters

handle

Database handle. The dataset will be created on the database identified by handle (input).

name

Name of the dataset to be created on the database (input).

type

Type of the dataset to be created on the database (input).

ndim

Number of array dimensions of the dataset to be created on the database (input).

dim

Array of dimensions ndim containing the size of each of the ndim dimensions of the dataset to be created on the database (input).

See also

mcDBresSet, mcDBresSuperset, mcDBinitSet