bson_array_alloc()¶
Synopsis¶
#define BSON_ARRAY_ALLOC(Count, Type) \
(Type*) bson_array_alloc (Count, sizeof (Type))
void *
bson_array_alloc (size_t num_elems, size_t elem_size);
Parameters¶
num_elems
: A size_t containing the number of objects to allocate.elem_size
: A size_t containing the size of each object in bytes.
Description¶
This is a portable malloc()
wrapper to allocate an array of objects.
If num_elems * elem_size
cannot be represented in a size_t or there was a failure to allocate num_elems * elem_size
bytes, the process will be aborted.
Warning
This function will abort on failure to allocate memory.
Returns¶
A pointer to a memory region which HAS NOT been zeroed.