Daylight v4.9
Release Date: 1 February 2008

Name

dt_delete - delete an object from a compound object

Generic Prototype

dt_delete(dt_Handle) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_delete(dt_Handle sequence)

FORTRAN Prototype

include 'dt_f_smiles.inc'

logical dt_f_delete(sequence)

integer*4 sequence

Description

Deletes the current object from the sequence. Makes the object preceding the deleted one be the current object (see dt_next(3)). dt_next(3) will return the same object as it would have before the deletion occurred.

It is an error to invoke this function when the current object is not a real object. You cannot delete from an empty sequence, or when dt_atstart(3) would return TRUE.

Return Value

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

Related Topics

dt_alloc_seq(3) dt_atend(3) dt_atstart(3) dt_count(3) dt_next(3) dt_reset(3) dt_append(3) dt_insert(3) dt_seqsort(3) dt_toend(3)