Daylight v4.9
Release Date: 1 February 2008

Name

dt_base - retrieve the base object of an object

Generic Prototype

dt_base(dt_Handle) => dt_Handle

C Prototype

#include "dt_smiles.h"

dt_Handle dt_base(dt_Handle object)

FORTRAN Prototype

include 'dt_f_smiles.inc'

integer*4 dt_f_base(object)

integer*4 object

Description

Finds the "base object", the object from which a given object is derived. If an object has a base object, its existence depends on that object: if the base object is deallocated, the object is also deallocated. An object is never its own base, and an object's base and parent (see dt_parent(3)) are never the same.

The base object of a stream is the object that was the first parameter to dt_stream(3).

The base object of a substructure, depiction or conformation is the molecule or reaction from which the object is derived. The base object of a path or pathset is the molecule or reaction from which it is derived.

Return Value

Returns the handle for the base object of a given object 'object' or NULL_OB if the object has no base object, or if an error is detected.

Related Topics

dt_adjunct(3) dt_parent(3) dt_setadjunct(3)