Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper 5.2 . Drivers Guide - <b>dbappend() function</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 DBAPPEND() function
 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, then
        checks for a network error:

        USE Sales NEW
        SET INDEX TO Sales

        DBAPPEND(.F.)

        IF NETERR()
           ? "A network error has occurred!"
        ENDIF

 Status:  Enhanced

 See also:  APPEND BLANK

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson