Daylight v4.9
Release Date: 1 February 2008


dt_invalid - test if an object handle is invalid

Generic Prototype

dt_invalid(dt_Handle) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_invalid(dt_Handle object)

FORTRAN Prototype

include ''

logical dt_f_invalid(object)

integer*4 object


Determines if the object handle refers to an invalid object.

Return Value

If 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 Topics

dt_type(3) dt_typename(3) dt_vh_stop_here(3)