5.1.1 Guarded malloc() with generic allocators

Usage example:

cce_location_t        L[1];
ccmem_clean_handler_t P_H[1];

if (cce_location(L)) {
  cce_run_catch_handlers_raise(L, upper_L);
} else {
  void *      P = ccmem_malloc_guarded(L, P_H,
                    ccmem_standard_allocator, 4096);

  memset(P, 0, 4096);
  cce_run_body_handlers(L);
}

Function: void * ccmem_malloc_guarded_clean (cce_destination_t L, ccmem_clean_handler_t * P_H, ccmem_allocator_t const * A, size_t size)

Wrapper for ccmem_malloc() that registers the allocated memory to be released by the handler referenced by P_H.

Function: void * ccmem_malloc_guarded_error (cce_destination_t L, ccmem_error_handler_t * P_H, ccmem_allocator_t const * A, size_t size)

Wrapper for ccmem_malloc() that registers the allocated memory to be released by the handler referenced by P_H.

Preprocessor Macro: void * ccmem_malloc_guarded (cce_destination_t L, P_H, ccmem_allocator_t const * A, size_t size)

If the argument P_H is a pointer of type:

ccmem_clean_handler_t

The macro use expands into a call to ccmem_malloc_guarded_clean().

ccmem_error_handler_t

The macro use expands into a call to ccmem_malloc_guarded_error().

This document describes version 0.2.2-devel.3 of CCMemory.