ORDKEYNO()
 Obtiene el número de registro lógico del registro actual
------------------------------------------------------------------------------
 Sintaxis

     ORDKEYNO([<cOrden> | <nPosición>],
        [<cFichIndice>]) --> nNumClave

 Argumentos

     <cOrden> | <nPosición> es el nombre del orden o un número que
     representa su posición en la lista de órdenes. Es preferible utilizar
     un nombre en vez de una posición ya que con esta última puede existir
     confusión en ficheros índice con varios órdenes. Si se omite o se
     establece a NIL, se utiliza el orden de control por defecto.

     Si se especifica un orden incorrecto, se produce un error de
     ejecución.

     <cFichIndice> es el nombre de un fichero índice, incluidos
     opcionalmente la unidad y el directorio (no es necesario especificar la
     extensión). Este argumento puede utilizarse junto con <cOrden> para
     deshacer la ambigüedad en situaciones en las que existen dos o más
     órdenes con el mismo nombre en ficheros índice distintos.

     Si el proceso actual no ha abierto <cFichIndice>, se produce un error
     de ejecución.

 Devuelve

     ORDKEYNO() devuelve un valor numérico que representa la posición
     relativa en el orden del registro actual. ORDKEYNO() tiene en cuenta el
     ámbito y la condición FOR del índice, y devuelve cero si el puntero del
     registro está situado en un registro no válido o si EOF() devuelve el
     valor verdadero (.T.).

 Descripción

     ORDKEYNO() devuelve el número de registro lógico de una clave en un
     orden. En contraste, la función RECNO() devuelve el número de registro
     físico, que es la posición relativa del registro en el fichero de base
     de datos físico.

     Consejo: Esta función se puede utilizar para visualizar barras de
     desplazamiento y mensajes, tales como "Registro 9 de 123," mientras se
     están examinando los registros.

     Por defecto, esta función opera en el área de trabajo seleccionada. Si
     desea utilizarla en otra área de trabajo, debe especificarla con una
     expresión de alias.

 Ejemplos

      Este ejemplo muestra las diferencias entre el número de
        registro físico y lógico:

        USE Cliente                  // Se suponen 1000 registros
        SET INDEX TO Nombre          // ordenados por nombre


        GO TOP                       // Se desplaza el puntero de datos al
                                     // primer registro

        ? ORDKEYNO()                 // Resultado: 1

        DBSKIP(10)
        ? ORDKEYNO()                 // Resultado: 11
        ? RECNO()                    // Resultado: Número de registro físico

        DBGOBOTTOM()
        ? ORDKEYNO()                 // Resultado: 1000
        ? RECNO()                    // Resultado: Número de registro físico

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: ORDKEYCOUNT() ORDKEYGOTO() ORDSCOPE() RECNO()