Download Dynamic C Function Reference Manual

Transcript
pfirst_fast
xmem void * pfirst_fast( Pool_t * p );
DESCRIPTION
Get the first allocated element in a root pool. The pool MUST be set to being a linked pool by
using:
pool_link(p, <non-zero>);
Otherwise the results are undefined.
This is an assembler-only version of pfirst().
*** Do _not_ call this function from C. ***
REGISTERS
Parameter in IX
Trashes F, DE
Return value in HL, carry flag
EXAMPLE
ld ix,my_pool
lcall pfirst_fast
jr c,.no_elems
; HL points to first element
PARAMETERS
p
Pool handle structure, as previously passed to pool_init(). Pass this
in the IX register.
RETURN VALUE
C flag set, HL=0: There are no allocated elements.
C flag clear (NC): HL points to first element.
LIBRARY
POOL.LIB
SEE ALSO
pool_init, pool_link, pfirst, pnext_fast
328
rabbit.com
Dynamic C Functions