Daylight v4.9
Release Date: 1 February 2008

Name

dt_addatom - add an atom to a molecule

Generic Prototype

dt_addatom(dt_Handle, dt_Integer, dt_Integer) => dt_Handle

C Prototype

#include "dt_smiles.h"

dt_Handle dt_addatom(dt_Handle mol, dt_Integer atomno, dt_Integer hcount)

FORTRAN Prototype

include 'dt_f_smiles.inc'

integer*4 dt_f_addatom(mol, atomno, hcount)

integer*4 mol
integer*4 atomno
integer*4 hcount

Description

Adds an atom with atomic number 'atomno' and 'hcount' attached hydrogens to the given molecule.

This may only be applied when the molecule is in modify-on state (see dt_mod_on(3)). Atoms may be removed by deallocating them (see dt_dealloc).

Return Value

Returns the handle of the new atom, or the NULL_OB if an error is detected.

Related Topics

dt_addbond(3) dt_alloc_mol(3) dt_mod_is_on(3) dt_mod_off(3) dt_mod_on(3) dt_setnumber(3) dt_setweight(3)