 |
Home | Features | Reference | Downloads | About |
Reference/es_mb_new
Syntax
int es_mb_new( struct es_mbd *definition, struct es_mb **res );
Arguments
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. |
Description
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.