ORDKEYCOUNT()
 Devuelve el número de claves de un orden
------------------------------------------------------------------------------
 Sintaxis

     ORDKEYCOUNT([<cOrden> | <nPosición>],
        [<cFichIndice>]) --> nClaves

 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

     ORDKEYCOUNT() devuelve el número de claves del orden especificado.

 Descripción

     ORDKEYCOUNT() devuelve el número de claves de un orden. Si el orden no
     es condicional ni tiene definido un ámbito, ORDKEYCOUNT() trabaja del
     mismo modo que RECCOUNT(), es decir, devuelve el número de registros de
     la base de datos. Sin embargo, es posible que un orden condicional
     contenga menos claves que registros, ya que puede que algunos registros
     no cumplan la condición FOR o no estén comprendidos en el ámbito
     especificado por ORDSCOPE() (al contar las claves, ORDKEYCOUNT()
     respeta el ámbito y la condición FOR).

     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 cómo utilizar ORDKEYCOUNT() con varios
        órdenes:

        USE Cliente
        // Se suponen 1000 registros,
        // de los cuales 500 poseen un valor para la edad menor
        // que 30 y 895 un valor para el salario menor que 50,000

        INDEX ON Edad TO Edad
        INDEX ON Nombre TO Nombre FOR Edad < 30
        INDEX ON Apellidos TO Apellidos FOR Salario < 50000

        // Edad es el orden de control
        SET INDEX TO Edad, Nombre, Apellidos

        ? RECCOUNT()                 // Resultado: 1000
        ? ORDKEYCOUNT()              // Resultado: 1000

        ? ORDKEYCOUNT("Nombre")      // Resultado: 500
        ? ORDKEYCOUNT(3)             // Resultado: 895

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: ORDKEYGOTO() ORDKEYNO() ORDSCOPE()