Release Date: 1 February 2008
Namedt_alloc_substruct - allocate a new substructure object
Generic Prototypedt_alloc_substruct(dt_Handle) => dt_Handle
C Prototype#include "dt_smiles.h"
dt_Handle dt_alloc_substruct(dt_Handle object)
FORTRAN Prototypeinclude 'dt_f_smiles.inc'
DescriptionAllocates a new substructure object for the given molecule or reaction. The substructure object is initially empty (no atoms or bonds).
Each substructure has 'object' as its base object (see dt_base(3)). If the base object is deallocated or modified, the substructure object will automatically be deallocated and its handle will be revoked.
Note that there is no theoretical limit to the number of substructures that may be created for a single object.
Return ValueReturns the handle of a new substructure object, or NULL_OB if 'object' is not a molecule or reaction object.
Related Topicsdt_add(3) dt_alloc_path(3) dt_member(3) dt_remove(3)