Name
pitem:IsNull -- check if item is invalid
Synopsis
bool = pitem:IsNull()
Function
Returns True if the item is NULL, i.e. invalid. If functions that allocate objects fail, they might not throw an error but simply set the object to NULL. You can use this function to check if object allocation has failed in which case the item will be NULL.

Also, certain getter functions can return a NULL object in case the object doesn't exist. You can use this function to check if a getter function returned a NULL handle.

Inputs
none

Results
bool
True if the item is NULL, otherwise False

Show TOC