Files
harbour-core/doc/en/dbsdf.txt
Viktor Szakats 58faf91453 2016-01-14 19:17 UTC+0100 Viktor Szakats (vszakats users.noreply.github.com)
* *
    % remove brandings and homepage [1] from copyright header. Pass 1 - using script.
      [1] nobody has access to it anymore AFAIK - and it's also just
          a redirect since long
    ! update url in copyright header
    ; this should make the diff between 3.4 and 3.2 easier to manage
2016-01-14 19:18:17 +01:00

76 lines
2.4 KiB
Plaintext

/*
* The following parts are Copyright of the individual authors.
*
* Copyright 2001-2002 David G. Holm <dholm@jsd-llc.com>
* Documentation for: __dbSDF()
*
* See COPYING.txt for licensing terms.
*
*/
/* $DOC$
$TEMPLATE$
Procedure
$NAME$
__dbSDF()
$CATEGORY$
API
$SUBCATEGORY$
Database
$ONELINER$
Copies the contents of a database to an SDF text file or
appends the contents of an SDF text file to a database.
$SYNTAX$
__dbSDF( <lExport>, <xcFile>, [<aFields>],
[<bFor>], [<bWhile>], [<nNext>], [<nRecord>], <lRest> )
$ARGUMENTS$
<lExport> If set to .T., copies records to an SDF file.
If set to .F., append records from an SDF file.
<xcFile> The name of the text file to copy to or append from.
If a file extension is not specified, ".txt" is used by default.
<aFields> An aray of field names to limit the processint to. If
not specified, or if empty, then all fields are processed.
<bFor> An optional code block containing a FOR expression that
will reduce the number of records to be processed.
<bWhile> An optional code block containing a WHILE expression
that will reduce the number of records to be processed.
<nNext> If present, but <nRecord> is not present, specifies to
process this number of records, starting with the current record.
A value of 0 means to process no records.
<nRecord> If present, specifies the only record to process. A
value of 0 means to process no records. Overrides <nNext> and <lRest>.
<lRest> If <lExport> is .T., then if <lRest> is set to .T. and there are no
<nRecord>, <nNext>, or <bWhile> arguments, processes all records from
current to last.
$DESCRIPTION$
__dbSDF() copies all or selected contents of a database table
to an SDF text file or appends all or selected contents of an
SDF text file to a database table.
$EXAMPLES$
// Copy delinquent accounts into an SDF text file.
USE ACCOUNTS NEW
COPY TO overdue SDF FOR ! Empty( accounts->duedate ) ;
.AND. Date() - accounts->duedate > 30
// Import new customer records.
USE CUSTOMER NEW
APPEND FROM customer SDF
$STATUS$
S
$COMPLIANCE$
C
$PLATFORMS$
All
$FILES$
$SEEALSO$
__dbDelim(), APPEND FROM, COPY TO
$END$
*/