Release Date: 1 February 2008
Namedt_invalid - test if an object handle is invalid
Generic Prototypedt_invalid(dt_Handle) => dt_Boolean
C Prototype#include "dt_smiles.h"
dt_Boolean dt_invalid(dt_Handle object)
FORTRAN Prototypeinclude 'dt_f_smiles.inc'
DescriptionDetermines if the object handle refers to an invalid object.
Return ValueIf the Daylight Toolkit is of the vigilant type, and if the given object is determined to be invalid, this function will return TRUE. Otherwise, returns FALSE. In other words, a return of TRUE guarantees that the handle is invalid. A return value of FALSE doesn't guarantee anything.
This is intended as a debugging aid, it cannot be used as a general-purpose programming tool. Callers should not assume that invalid handles can always be detected.
Related Topicsdt_type(3) dt_typename(3) dt_vh_stop_here(3)