DBGOTO()

Position the record pointer to a specific location.

Syntax

DBGOTO(<xRecordNumber>) --> NIL

Arguments

<xRecordNumber> Record number or unique identity

Returns

DBGOTO() always returns NIL.

Description

This function places the record pointer,if working with a .DBF file, in selected or aliased work area at the record number specified by .The position if not affected by an active index or by any enviromental SET condiction.

Issuing a DBGOTO(RECNO()) call in a network enviroment will refresh the database and index buffers.This is the same as a DBSKIP(0) call. The parameter may be something other than a record number.In some data formats, for example, the value of is a unique primary key while in other formats, could be an array offset if the data set was an array.

Examples


The following example uses DBGOTO() to iteratively process
every fourth record:
DBUSEAREA( .T., "DBFNTX", "Sales", "Sales", .T. )
//
// toggle every fourth record
DO WHILE !EOF()
DBGOTO( RECNO() + 4 )
Sales->Group := "Bear"
ENDDO

Status

Ready

Compliance

This function is CA-Clipper compliant.

Files

Library is rdd

See Also