C and C++ Libraries and Floating-Point Support Reference

__user_heap_extend()

ARM Compiler toolchain v5.02 for µVision ARM C and C++ Libraries and Floating-Point Support Reference

Home > The C and C++ libraries > __user_heap_extend()

`__user_heap_extend()`

Defined in rt_misc.h, this function can be defined to return extra blocks of memory, separate from the initial one, to be used by the heap. If defined, this function must return the size and base address of an eight-byte aligned heap extension block.

Syntax

extern unsigned __user_heap_extend(int var0, void **base, unsigned requested_size);

Usage

There is no default implementation of this function. If you define this function, it must have the following characteristics:

The returned size must be either:
- a multiple of eight bytes of at least the requested size
- 0, denoting that the request cannot be honored.
Size is measured in bytes.
The function is subject only to ARM Architecture Procedure Call Standard (AAPCS) constraints.
The first argument is always zero on entry and can be ignored. The base is returned in the register holding this argument.
The returned base address must be aligned on an eight-byte boundary.

Returns

This function places a pointer to a block of at least the requested size in *base and returns the size of the block. 0 is returned if no such block can be returned, in which case the value stored at *base is never used.

C and C++ Libraries and Floating-Point Support Reference

__user_heap_extend()

`__user_heap_extend()`

Syntax

Usage

Returns

See also

Products

Development Tools

Hardware & Collateral

Downloads

Support

Contact

Important information