PK_ERROR_code_t PK_MEMORY_alloc
(
--- received arguments ---
size_t          nbytes,            --- number of bytes required

--- returned arguments ---
void    **const pointer            --- allocated memory (possibly NULL)
)


This function allocates the specified amount of memory required in bytes.


If the requested allocation cannot be met, the NULL pointer is returned.

If the application has registered an allocator function, this will be
used to allocate the memory.

The application supplied error handler will not be called if there is a
problem, despite an error code being returned for the function value.

If zero bytes are requested, the function value will be
PK_ERROR_zero_bytes_required. If the requested allocation cannot be met,
the function value will be PK_ERROR_memory_full.