[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
DBAPPEND()
Append a new record to the database open in the current work area
------------------------------------------------------------------------------
Syntax
DBAPPEND([<lReleaseRecLocks>]) --> NIL
Arguments
<lReleaseRecLocks> is a logical data type that if true (.T.),
clears all pending record locks, then appends the next record. If
<lReleaseRecLocks> is false (.F.), all pending record locks are
maintained and the new record is added to the end of the Lock List. The
default value of <lReleaseRecLocks> is true (.T.).
Returns
DBAPPEND() always returns NIL.
Description
DBAPPEND() is a database function that lets you add records to the
current database. The enhancement to this function lets you maintain
multiple record locks during an append.
DBAPPEND() without a parameter as in earlier versions of CA-Clipper,
clears all pending record locks prior to an append. This is the same as
DBAPPEND(.T.).
Examples
. This example appends a blank record to the database, Sales,
without releasing the record locks in the current Lock List, and then
checks for a network error:
USE Sales NEW
SET INDEX TO Sales
DBAPPEND(.F.)
IF NETERR()
? "A network error has occurred!"
ENDIF
See Also:
APPEND BLANK
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson