Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_tdtremove_raw - remove a TDT from a database

Generic Prototype

dt_thor_tdtremove_raw(dt_Handle, dt_String, dt_String) => dt_Integer

C Prototype

#include "dt_thor.h"

dt_Boolean dt_thor_tdtremove_raw(dt_Handle database, dt_Integer taglen, dt_String tag, dt_Integer idlen, dt_String identifier)

FORTRAN Prototype

include 'dt_f_thor.inc'

logical dt_f_thor_tdtremove_raw(database, tag, identifier)

integer*4 database
character*4 tag
character*4 identifier

Description

Permanently removes a TDT from the database. The tag is not checked for validity (i.e. if there is no such datatype, nothing will be removed), and the identifier is not standardized (i.e. normalizations like unique-SMILES, removing punctuation and whitespace, converting to uppercase, etc.). In other words, you must use the exact tag and identifier as they appear in the database.

Return Value

If the TDT is found and removed, returns 1. If the TDT is not found, returns zero. If an error is detected, returns -1. When an error is detected, the TDT may or may not be removed from the database.

Related Topics

dt_thor_tdtget(3) dt_thor_tdtget_raw(3) dt_thor_tdtmerge(3) dt_thor_tdtput(3) dt_thor_tdtput_raw(3) dt_thor_tdtremove(3) dt_thor_tdtrevise(3) dt_thor_xrefget(3)