DBGOTO()
 Desplaza el puntero al registro que coincide con la identidad especificada.
------------------------------------------------------------------------------
 Sintaxis

     DBGOTO(<xIdentidad>) --> NIL

 Argumentos

     <xIdentidad> es un valor único en la estructura del fichero de
     datos que identifica de forma unívoca a uno de sus elementos. En
     ficheros con estructura de datos Xbase (.dbf), <xIdentidad> es el
     número de registro. En otros formatos de datos, <xIdentidad> es el
     valor de la clave principal. Si los datos están almacenados en memoria
     y no en el disco, <xIdentidad> puede contener el índice de una matriz o
     un manejador de memoria virtual.

 Devuelve

     DBGOTO() devuelve siempre NIL.

 Descripción

     DBGOTO() es una función de base de datos que desplaza el puntero al
     registro cuya identidad se corresponde con <xIdentidad> en el área de
     trabajo actual. En una estructura de datos del tipo Xbase, la identidad
     es el número de registro, ya que cada registro, incluidos los vacíos,
     poseen un número de registro distinto. En las restantes estructuras de
     datos, la identidad puede ser algo distinto del número de registro.

 Ejemplos

      En este ejemplo se almacena el número de registro actual, se
        realiza la búsqueda de una clave y se vuelve a situar el puntero en
        la posición de registro almacenada previamente:

        FUNCTION ExisteClave (xExprClave)

           LOCAL nRegistroAct := RECNO()        // Almacena la posición
                                                // del registro actual
           LOCAL lEncontrado

           SEEK xExprClave
           IF (lEncontrado := FOUND())
           .
           <sentencias>
           .
           ENDIF

           DBGOTO (nRegistroAct)                // Coloca el puntero en
                                                // la posición almacenada
           RETURN (lEncontrado)
 To download this example - click here.

See Also: BOF() DBGOBOTTOM() DBGOTOP() DBSEEK() DBSKIP()