__DBZAP()

Remove all records from the current database file

Syntax

__DbZap() -> NIL

Returns

__DbZap() will always return nil

Description

__DbZap( is a database command that permanently removes all records from files open in the current work area. This includes the current database file, index files, and associated memo file. Disk space previously occupied by the ZAPped files is released to the operating system. __DbZap() performs the same operation as DELETE ALL followed by PACK but is almost instantaneous.

To ZAP in a network environment, the current database file must be USEd EXCLUSIVEly.

      This example demonstrates a typical ZAP operation in a network
      environment:

      USE Sales EXCLUSIVE NEW
      IF !NETERR()
         SET INDEX TO Sales, Branch, Salesman
         __dbZAP()
         CLOSE Sales
      ELSE
         ? "Zap operation failed"
         BREAK
      ENDIF

Status

Ready

Compliance

This function is CA Clipper compliant

Files

Library is rdd