Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_getauxillarydb - return the name of an auxiliary database

Generic Prototype

dt_thor_getauxillarydb(dt_Handle, dt_Integer) => dt_String

C Prototype

#include "dt_thor.h"

dt_String dt_thor_getauxillarydb(dt_Integer *len, dt_Handle database, dt_Integer which_db)

FORTRAN Prototype

include 'dt_f_thor.inc'

character*() dt_f_thor_getauxillarydb(database, which_db)

integer*4 database
integer*4 which_db

Description

Gets the name of one of the auxiliary databases associated with 'database'.

The parameter 'which_db' indicates which of the auxiliary database's names is requested:

  DX_THOR_DATATYPESDB  return the datatypes database
  DX_THOR_INDIRECTDB   return the indirect-data database
Normally, a datatypes database will not have any auxiliary databases. Indirect-data databases will have an auxiliary datatypes database. Regular databases always have an auxiliary datatypes database, and may have an indirect-data database.

Return Value

Returns the path (directory, filename, and suffix) of the datatypes database, or the empty string if there is no datatypes database. For all other objects, the dt_thor_getauxillarydb(3) returns the 'invalid string'.

Related Topics

dt_database(3) dt_getdatabases(3) dt_open(3) dt_thor_setauxillarydb(3)