<< Previous | Next >>

xavail

long xavail( long * addr_ptr );

Description

Returns the maximum length of memory that may be successfully obtained by an immediate call to xalloc(), and optionally allocates that amount.

This function was introduced in Dynamic C version 7.04P3.

Parameters

addr_ptr

Pointer to a long word 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().

Return value

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

Library

XMEM.LIB (was in STACK.LIB prior to DC 8)

See Also

xalloc, _xalloc, _xavail, xrelease, xalloc_stats