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

Name

mcDBinitSet — Initialize set on database with value

Synopsis

#include <memcom.h>

int mcDBinitSet(int handle, const char* name, void* cval);

Description

mcDBinitSet initializes an existing set on the database identified by handle with a given constant value. The constant initialization value must correspond to the actual data type of the set. If completed successfully, the function returns 0. Otherwise, a negative value indicating the MemCom error number is returned. Note: Relational tables do not have to be initialised, since they are always initialised when created. mcDBinitSet makes use of a dynamically configurable auxiliary buffer, as opposed to previous versions of MemCom, where the buffer size was fixed.

Parameters

handle

Database handle of set to be initialized (input).

name

Dataset name of set to be initialized (input).

cval

Constant value to be used to initialize set (input). The type of cval must correspond to the set type.

See also

mcDBresSet, mcDBresSuperset