<< Previous | Next >>

_xavail

long _xavail( long * addr_ptr, word align, word type );

Description

Returns the maximum length of memory that may be successfully obtained by an immediate call to _xalloc(), and optionally allocates that amount. The align and type parameters are the same as would be presented to _xalloc().

Parameters

addr_ptr

Address of a longword, in root data memory, to store the address of the block. If this pointer is null, then the block is not allocated. Otherwise, the block is allocated as if by a call to _xalloc().

align

Alignment of returned block, as per _xalloc().

type

Type of memory, as per _xalloc().

Return value

The size of the largest free block available. If this is zero, then *addr_ptr will not be changed.

Library

XMEM.LIB

See Also

xalloc, _xalloc, xavail, xrelease, xalloc_stats