CheckItem

Checks to see if an item exists.

Synopsis

void *CheckItem( Item i, uint8 ftype, uint8 ntype )

Description

This procedure checks to see if a specified item exists. To specify the item, you use an item number, an item-type number, and the item number of the folio in which the item type is defined. If all three of these values match those of the item, the procedure returns a pointer to the item.

Arguments

i
The item number of the item to be checked.
ftype
The item number of the folio that defines the item type. (This is the same value that is passed to the MkNodeID() macro.) For a list of folio item numbers, see the Portfolio Item's chapter.
ntype
The item-type number for the item. (This is the same value that is passed to the MkNodeID() macro.) For a list of item-type numbers, see the Portfolio Item's chapter.

Return Value

If the item exists (and the values of all three arguments match those of the item), the procedure returns a pointer to the item. If the item does not exist, the procedure returns NULL.

Implementation

Folio call implemented in kernel folio V20.

Associated Files

item.h
ANSI C Prototype
clib.lib
ARM Link Library

See Also

CreateItem(), FindItem(), FindNamedItem(), FindVersionedItem(), LookupItem(), MkNodeID()