Release Date: 1 February 2008
Namedt_thor_xrefget - retrieve a cross-reference from a database
Generic Prototypedt_thor_xrefget(dt_Handle, dt_Handle, dt_String, dt_Boolean) => dt_Handle
C Prototype#include "dt_thor.h"
dt_Handle dt_thor_xrefget(dt_Handle database, dt_Handle datatype, dt_Integer idlen, dt_String identifier, dt_Boolean *iserror)
FORTRAN Prototypeinclude 'dt_f_thor.inc'
integer*4 dt_f_thor_xrefget(database, datatype, identifier, iserror)
DescriptionGets cross-reference data from a database. A cross-reference contains a sequence of string objects. The first string object in the sequence contains the original identifier 'identifier' and the second through last strings contain the SMILES of a TDT in which that identifier/datatype appears.
Note that the returned identifier will be normalized.
The calling application is responsible for deallocating the strings and sequence (the strings are not automatically deallocated when the sequence is deallocated).
Note also that a cross-reference sequence object may become out of date as TDT's are written to the database.
Return ValueReturns a sequence of strings containing cross-reference information or the NULL_OB if the identifier does not appear in any SMILES-rooted tree or if an error is encountered. If the NULL_OB is returned, 'iserror' will be TRUE if there was an error encountered, and FALSE if no error is encountered.
Related Topicsdt_thor_str2tdt(3) dt_thor_tdt2str(3) dt_thor_tdtget(3) dt_thor_tdtmerge(3) dt_thor_tdtput(3) dt_thor_tdtputforced(3) dt_thor_tdtputraw(3) dt_thor_tdtremove(3) dt_thor_tdtrevise(3)