Gets a single memory block from the heap.
This function is deprecated and will be removed in a future version of this product.
Files
lib_mem.h/lib_mem.c
Prototype
Arguments
size
Size of requested memory block (in octets).
align
Alignment of requested memory block (in octets).
poctets_reqd
Pointer to a variable to …
Return the number of octets required to successfully allocate the memory block, if any errors;
Return 0, otherwise.
perr
Pointer to variable that will receive the return error code from this function:
LIB_MEM_ERR_NONE
LIB_MEM_ERR_INVALID_MEM_SIZE
LIB_MEM_ERR_INVALID_MEM_ALIGN
LIB_MEM_ERR_HEAP_EMPTY
LIB_MEM_ERR_HEAP_OVF
Returned Value
Pointer to memory block, if no errors;
Pointer to NULL, otherwise.
Required Configuration
Available only if LIB_MEM_CFG_HEAP_SIZE is > 0 in lib_cfg.h.
Notes / Warnings
None.