WYRDTEK Home Features Reference Downloads About



int es_mb_new( struct es_mbd *definition, struct es_mb **res );


struct es_mbd *definition Database definition or schema.
struct es_mb **res Assigned result. Passed by reference.

Return Codes

ES_ERROR_NONE Success. No errors.
ES_ERROR_INVALIDSCHEMA definition is NULL or does not contain any class definitions.


Constructs a new in-memory, in-process database with respect to a provided database definition, or schema. An empty node for each root class in the definition - i.e. a class that does not have a parent - is also constructed.

Databases constructed by es_mb_new must be subsequently destroyed by a call to es_mb_delete.

es_mb_new may fail if the supplied database definition is invalid or if either the system is out of resources or if a software license has not been initialized via a call to es_init, in which case the process will abort with an error message to stderr.

[Back To Reference] [Back To Reference/es_mb]