DBGOTOP()
 Desplaza el cursor al primer registro lógico
------------------------------------------------------------------------------
 Sintaxis

     DBGOTOP() --> NIL

 Devuelve

     DBGOTOP() devuelve siempre NIL.

 Descripción

     DBGOTOP() desplaza el cursor al primer registro lógico del área de
     trabajo actual.

     DBGOTOP() realiza la misma función que un mandato GO TOP estándar. Si
     desea más información, consulte el mandato GO TOP.

 Notas

     ■ Registros lógicos: DBGOTOP() actúa sobre registros lógicos. Si
        existe un índice activo, DBGOTOP() desplaza el cursor al primer
        registro en orden según el índice. Si hay establecido un filtro,
        sólo se examinan los registros que cumplen con la condición del
        filtro.

     ■ Orden de control: Si hay activo más de un índice en el área de
        trabajo, la operación se realiza utilizando el orden de control
        establecido con la función DBSETORDER() o el mandato SET ORDER. Si
        desea más información, consulte el mandato SET ORDER.

     ■ Entorno de red: Al desplazarse a otro registro en un entorno
        de red, las modificaciones efectuadas en el registro actual se hacen
        visibles a los otros procesos. Si desea más información, consulte el
        capítulo "Programación en Red" en la Guía de Programación y
        Utilidades. Esta función no modifica el estado de bloqueo de los
        registros

 Ejemplos

      Este ejemplo muestra la utilización normal de DBGOTOP():

        DBGOTOP()
        WHILE ( !EOF() )
           ? FIELD->Nombre
           DBSKIP()
        END

 Ficheros   La biblioteca asociada es CLIPPER.LIB.
 To download this example - click here.

See Also: BOF() DBGOBOTTOM() DBSEEK() DBSKIP() EOF() GO