Oracle C++ Call Interface Programmer's Guide

Environment Class
method. If no memory manager functions are specified, then OCCI uses its own
default functions. An Environment object must eventually be closed to free all the
system resources it has acquired.
If the mode specified is THREADED_MUTEXED or THREADED_UN_MUTEXED,
then all three memory management functions must be thread-safe.
Syntax
static Environment * createEnvironment(Mode mode = DEFAULT,
void *ctxp = 0,
void *(*malocfp)(void *ctxp, size_t size) = 0,
void *(*ralocfp)(void *ctxp, void *memptr, size_t newsize) = 0,
void (*mfreefp)(void *ctxp, void *memptr) = 0);
Parameters
mode
Valid values are:
DEFAULT not thread safe, not in object mode
THREADED_MUTEXED thread safe, mutexed internally by OCCI
THREADED_UN-MUTEXTED thread safe, client responsible for mutexing
OBJECT uses object features
ctxp
Context pointer for user-defined memory management function.
size_t
The size of the memory to be allocated by user-defined memory allocation function.
malocfp
User-defined memory allocation function.
ralocfp
User-defined memory reallocation function.
mfreefp
User-defined memory free function.
OCCI Classes and Methods 8-65