ORDDESCEND()
 Devuelve y, opcionalmente, modifica el indicador de ordenación descendente
 de un orden
------------------------------------------------------------------------------
 Sintaxis

     ORDDESCEND([<cOrden> | <nPosición>],[<cFichIndice>],
        [<lNuevoIndicadorDescend>]) --> lActualIndicadorDescend

 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 valor no válido, se produce un error de ejecución.

     <cFichIndice> es el nombre de un fichero índice, incluidos
     opcionalmente la unidad y el directorio (no se debe 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.

     <lNuevoIndicadorDescend> es un valor lógico que, si tiene el valor
     verdadero (.T.), establece, para el orden, una ordenación descendente
     en ejecución. Si tiene el valor falso (.F.), establece una ordenación
     ascendente.

 Devuelve

     Si no se especifica <lNuevoIndicadorDescend>, ORDDESCEND() devuelve el
     valor actual del indicador. Si se especifica <lNuevoIndicadorDescend>,
     devuelve el valor previo del indicador.

 Descripción

     ORDDESCEND() modifica el indicador de ordenación ascendente/descendente
     sólo durante la ejecución (no modifica el valor del indicador
     almacenado en el fichero índice actual). Para modificar el valor del
     indicador en el fichero índice, consulte el mandato INDEX en el Manual
     de Consulta, volumen 1.

     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

      El ejemplo siguiente muestra la utilización de ORDDESCEND().
        Los órdenes se clasifican tanto de forma ascendente como descendente:

        USE Cliente VIA "DBFCDX"
        INDEX ON Apellido TAG Apell
        INDEX ON NombrePila TAG Nombre DESCENDING

        SET ORDER TO TAG Apell
        // Apell se creó con ordenación ascendente

        // Se modifica su ordenación
        ORDDESCEND(,, .T.)
        // Y se establece a descendente

        SET ORDER TO TAG Nombre
        // Nombre se creó con ordenación descendente

        // Se modifica su ordenación
        ORDDESCEND(,, .F.)
        // Y se establece a ascendente

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: INDEX