[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
DBGOTOP()
Move to the first logical record
------------------------------------------------------------------------------
Syntax
DBGOTOP() --> NIL
Returns
DBGOTOP() always returns NIL.
Description
DBGOTOP() moves to the first logical record in the current work area.
DBGOTOP() performs the same function as the standard GO TOP command.
For more information, refer to the GO TOP command.
Notes
. Logical records: DBGOTOP() operates on logical records. If
there is an active index, DBGOTOP() moves to the first record in
indexed order. If a filter is set, only records which meet the
filter condition are considered.
. Controlling order: If more than one index is active in the
work area, the 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.
This function will not affect the locked status of any record.
Examples
. This example demonstrates the typical use of DBGOTOP():
DBGOTOP()
WHILE ( !EOF() )
? FIELD->Name
DBSKIP()
END
Files Library is CLIPPER.LIB.
See Also:
BOF()
DBGOBOTTOM()
DBSEEK()
DBSKIP()
EOF()
GO
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson