Daylight v4.9
Release Date: 1 February 2008


dt_alloc_substruct - allocate a new substructure object

Generic Prototype

dt_alloc_substruct(dt_Handle) => dt_Handle

C Prototype

#include "dt_smiles.h"

dt_Handle dt_alloc_substruct(dt_Handle object)

FORTRAN Prototype

include ''

integer*4 dt_f_alloc_substruct(object)

integer*4 object


Allocates 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 Value

Returns the handle of a new substructure object, or NULL_OB if 'object' is not a molecule or reaction object.

Related Topics

dt_add(3) dt_alloc_path(3) dt_member(3) dt_remove(3)