lq-text: LQT_LastBlockInChain

API unsigned char * LQT_LastBlockInChain (db, WID, Offsetp, FirstUnusedBytepp, BlockLengthp) t_LQTEXT_Database *db; t_WID WID; unsigned long *Offsetp; /* in: first offset; Out: last offset */ unsigned char **FirstUnusedBytepp; /* out only */ unsigned int *BlockLengthp;

Purpose

Returns the last block in the chain for a given WID. The value may have been set previously by LQT_Set­Last­Block­In­Chain, or can be deduced by reading the chain from disk a block at a time until the end is reached.

Returns

A pointer to the (extended) block in the data cache

Errors

Fatal error (E_BUG) if the value cannot be determined

See Also: