Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_tdtremove - remove a TDT from a database

Generic Prototype

dt_thor_tdtremove(dt_Handle) => dt_Integer

C Prototype

#include "dt_thor.h"

dt_Integer dt_thor_tdtremove(dt_Handle tdt)

FORTRAN Prototype

include 'dt_f_thor.inc'

integer*4 dt_f_thor_tdtremove(tdt)

integer*4 tdt

Description

Permanently removes a TDT from the database. Does not affect the TDT object representing that same TDT, which may have been retrieved from the database. The TDT object should be deallocated separately using dt_dealloc(3) when it is no longer needed.

If record locking is enforced (see dt_thor_settdtlocking(3)), and the record is locked, the record will appear to this client to be deleted, but other clients will still "see" the record until the delete is "committed" (the record is unlocked). Locked records that are deleted can be also "rolled back" (the record undeleted) up to the point where is it "committed" (see dt_thor_tdtput(3)).

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_settdtlocking(3) 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_raw(3) dt_thor_tdtrevise(3) dt_thor_xrefget(3)