<< Previous | Next >>

pxfirst_fast

xmem long pxfirst_fast( Pool_t * p );

Description

Get the first allocated element in an xmem pool. The pool MUST be set to being a linked pool using pool_link(p, <non-zero>); otherwise, the results are undefined.

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

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

Registers

Parameter in IX
Trashes F, HL
Return value in BCDE, carry flag

Example

   

ld ix,my_pool
lcall pxfirst_fast
jr c,.no_elems
; BCDE points to first element

Parameters

p

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

Return value

C flag set: There are no allocated elements
C flag clear (NC): BCDE points to first element

Library

POOL.LIB

See Also

pool_xinit, pool_link, pxfirst, pxnext_fast