MemCom Reference Manual > MemCom C API Manual Pages > Relational Table Manager Functions > mcTBcreate

Name

mcTBcreate — Create relational table

Synopsis

#include <memcom.h>

mcRTable* mcTBcreate(mcSize size);

Description

mcTBcreate creates a relational table in memory (not on the database, to create a relational table on the database make use of mcDBresSet or mcDBresSuperset).

If completed successfully, the function returns a pointer to the new table in memory (not on the database). Otherwise, NULL is returned and the error code can be retrieved by the function mcErrStatus. To free the table from memory make use of mcTBfree. Note that the minimum table size is 4 bytes.

Parameters

size

Size of relational table in bytes (input). If size is set to 0, the default size of 4096 bytes will be selected. size is positive but smaller than 4 bytes size will be set to 4 bytes.

See also

mcTBfree.