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