36 lines
534 B
ReStructuredText
36 lines
534 B
ReStructuredText
PR_NEW
|
|
======
|
|
|
|
Allocates memory of a specified size from the heap.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#include <prmem.h>
|
|
|
|
_type * PR_NEW(_struct);
|
|
|
|
|
|
Parameter
|
|
~~~~~~~~~
|
|
|
|
``_struct``
|
|
The name of a type.
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
An pointer to a buffer sized to contain the type ``_struct``, or if the
|
|
allocation attempt fails, ``NULL``. Call ``PR_GetError()`` to retrieve
|
|
the error returned by the libc function.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
This macro allocates memory whose size is ``sizeof(_struct)`` and
|
|
returns a pointer to that memory.
|