F.FIND - find the named entry in a type 0 or 1 block.

Usage:

ptr = f.find( sector, substruct );

Where:

sector
is the memory pointer of a type 0 or type 1 FMS catalog sector.
substruct
is the pointer to a two-word BCD substructure name.
ptr
is a pointer to the entry in the type 0 or 1 block which describes the requested entry.

Description:

The chain of type 0 and 1 blocks beginning at the provided block is searched for the named substructure. When it is found, a pointer to the entry is returned.

This pointer may be indexed into by the FMS constants .H0SNM and .H0SPT, giving the name and substructure pointer.

It is not guaranteed that the original sector will remain in memory.

Copyright © 1996, Thinkage Ltd.