Daylight v4.9
Release Date: 1 February 2008

Name

dt_remove - remove an object from a compound object

Generic Prototype

dt_remove(dt_Handle, dt_Handle) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_remove(dt_Handle set, dt_Handle object)

FORTRAN Prototype

include 'dt_f_smiles.inc'

logical dt_f_remove(set, object)

integer*4 set
integer*4 object

Description

Remove the given object 'object' from the path or substructure 'set'. The parameter 'set' must be the handle of an atom or bond from the base molecule of 'set'.

Removing an object from a substructure may cause the order of object in the substructure to change in arbitrary ways. Removing an object from a path leaves the order of the remaining object unchanged.

This function modifies 'set', so streams over the object are revoked.

Return Value

Returns the success (TRUE) or failure (FALSE) of the operation.

Related Topics

dt_add(3) dt_alloc_path(3) dt_alloc_substruct(3) dt_member(3)