[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
DBSKIP()
Move relative to the current record
------------------------------------------------------------------------------
Syntax
DBSKIP([<nRecords>]) --> NIL
Arguments
<nRecords> is the number of logical records to move, relative to the
current record. A positive value means to skip forward, and a negative
value means to skip backward. If <nRecords> is omitted, a value of 1 is
assumed.
Returns
DBSKIP() always returns NIL.
Description
DBSKIP() moves either forward or backward relative to the current
record. Attempting to skip forward beyond the last record positions the
work area to LASTREC() + 1 and EOF() returns true (.T.). Attempting to
skip backward beyond the first record positions the work area to the
first record and BOF() returns true (.T.).
DBSKIP() performs the same function as the standard SKIP command. For
more information, refer to the SKIP command.
Notes
. Logical records: DBSKIP() operates on logical records. If
there is an active index, records are considered in indexed order.
If a filter is set, only records which meet the filter condition are
considered.
. Controlling order: If the work area has more than one active
index, the skip operation is performed using the controlling order as
set by DBSETORDER() or the SET ORDER command. For more information,
refer to the SET ORDER command.
. Network environment: For a shared file on a network, moving to
a different record may cause updates to the current record to become
visible to other processes. For more information, refer to the
"Network Programming" chapter in the Programming and Utilities Guide.
Examples
. This example demonstrates a typical use of the DBSKIP()
function:
DBGOTOP()
DO WHILE ( !EOF() )
? FIELD->Name
DBSKIP()
ENDDO
Files Library is CLIPPER.LIB.
See Also:
BOF()
DBGOBOTTOM()
DBGOTOP()
DBSEEK()
EOF()
SKIP
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson