Daylight v4.9
Release Date: 1 February 2008

Name

dt_alloc_path - allocate a new path object

Generic Prototype

dt_alloc_path(dt_Handle) => dt_Handle

C Prototype

#include "dt_smiles.h"

dt_Handle dt_alloc_path(dt_Handle object)

FORTRAN Prototype

include 'dt_f_smiles.inc'

integer*4 dt_f_alloc_path(object)

integer*4 object

Description

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

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

Related Topics

dt_add(3) dt_alloc_substruct(3) dt_member(3) dt_remove(3)