Function xalloc_init()

Function Documentation

void xalloc_init()

This function must be called exactly one time before the operating system threading starts. If using xallocator exclusively in C files within your application code, you must call this function before the OS starts. If using C++, client code does not call xalloc_init. Let XallocInitDestroy() call xalloc_init automatically. Embedded systems that never exit can call xalloc_init() manually at startup and eliminate XallocInitDestroy usage. When the system is still single threaded at startup, the xallocator API does not need mutex protection.

This function must be called exactly one time before any other xallocator API is called. XallocInitDestroy constructor calls this function automatically.