Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_xrefget - retrieve a cross-reference from a database

Generic Prototype

dt_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 Prototype

include 'dt_f_thor.inc'

integer*4 dt_f_thor_xrefget(database, datatype, identifier, iserror)

integer*4 database
integer*4 datatype
character*() identifier
logical iserror

Description

Gets 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 Value

Returns 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 Topics

dt_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)