<< Previous | Next >>

xalloc

long xalloc( long sz );

Description

Allocates the specified number of bytes in extended memory. Starting with Dynamic C version 7.04P3, the returned address is always even (word) aligned.

Starting with Dynamic C 8, if xalloc() fails, a run-time error will occur. This is a wrapper function for _xalloc(), for backwards compatibility. It is the same as _xalloc(&sz, 1, XALLOC_MAYBBB) except that the actual allocated amount is not returned since the parameter is not a pointer.

Starting with Dynamic C 9.30, xalloc() and related functions were modified so that they are now driven by the compiler origin directives.

NOTE	xalloc() is not thread safe since it accesses a global static structure with no locking.

Parameters

sz

Number of bytes to allocate. This is rounded up to the next higher even number.

Return value

The 20-bit physical address of the allocated data: Success.
0: Failure.

NOTE	Starting with Dynamic C 8, a run-time exception will occur if the function fails.

Library

STACK.LIB

See also

root2xmem, xmem2root, xavail