29 lines
489 B
Markdown
29 lines
489 B
Markdown
# 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.
|