xHarbour Reference Documentation > Function Reference

DbRecall()

Recalls a record previousy marked for deletion.

Syntax

DbRecall() --> NIL

Return

The return value is always NIL.

Description

The DbDelete() function removes the deletion flag from a record marked as deleted. The deletion flag is set with function DbDelete().

Not that if SET DELETED is set to ON, functions and commands for relative database navigation ignore all records having the deleted flag set. This way, they become unvisible.

In a networking situation, this function requires the current record be locked prior to calling the DbRecall() function.

Info

See also:	DbDelete(), DELETE, Deleted(), NetRecall(), RECALL
Category:	Database functions
Source:	rdd\dbcmd.c
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example demonstrates how to set and detect the deletion flag

   PROCEDURE Main
      USE Customer EXCLUSIVE
      DbGoto(10)

      DbDelete()
      ? Deleted()                      // result: .T.

      DbRecall()
      ? Deleted()                      // result: .F.

      USE
   RETURN