<< Previous | Next >>

palloc_fast

xmem void * palloc_fast( Pool_t * p );

Description

Return next available free element from the given pool, which must be a root pool.

This is an assembler-only version of palloc().

*** Do _not_ call this function from C. ***

palloc_fast does not perform any IPSET protection, parameter validation, or update the high-water mark. palloc_fast is a root function. The parameter must be passed in IX, and the returned element address is in HL.

Registers

Parameter in IX
Trashes F, BC, DE
Return value in HL, carry flag.

Example

ld ix,my_pool
lcall palloc_fast
jr c,.no_free
; HL points to element

Parameters

p

Pool handle structure, as previously passed to pool_init(). Pass this in IX.

Return value

C flag set: no free elements were available.
C flag clear (NC): HL points to an element.

If the pool is not linked, your application can use this element provided it does not write more than p->elsize bytes to it (this was the elsize parameter passed to pool_init()). If the pool is linked, you can write p->elsize-4 bytes to it.

Library

POOL.LIB

See Also

pool_init, pfree_fast, pavail_fast, palloc