dt_thor_tdtput

Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_tdtput_raw - insert a string into a database

Generic Prototype

dt_thor_tdtput_raw(dt_Handle, dt_String, dt_Integer) => dt_Boolean

C Prototype

#include "dt_thor.h"

dt_Boolean dt_thor_tdtput_raw(dt_Handle database, dt_Integer slen, dt_String tdtstr, dt_Integer how)

FORTRAN Prototype

include 'dt_f_thor.inc'

integer*4 dt_f_thor_tdtput_raw(database, string, how)

integer*4 database
character*() string
integer*4 how

Description

This function works very much like dt_thor_tdtput(3), except that instead of taking a TDT object, it takes a string directly. It puts the TDT string directly into the database without creating a TDT object, without any normalization, and without any of the safeguards and checking which usually occur. Very fast and very dangerous.

This function is only for reloading data that was dumped from an existing Thor database (see dt_stream(3), thorlist(1), thordump(1)) using the exact same release of Daylight software. This is intended to be used as a faster method of reloading data that are already "standardized" correctly.

The parameter "how" controls how data are to be combined with existing data in the database, and whether to lock, unlock, or "rollback" a lock. See the description of the "how" parameter in dt_thor_tdtput(3).

Return Value