INDEXORD()
 Retorna a posiçao de ordem do índice controlador
------------------------------------------------------------------------------

 Sintaxe

     INDEXORD() --> nOrdem

 Retorno

     INDEXORD() retorna um valor numérico inteiro.  O valor retornado é
     igual à posiçao do índice controlador na lista de índices abertos na
     área de trabalho corrente.  Um valor de zero indica que nao há índice
     controlador e que os registros estao sendo acessados em ordem natural.

 Descriçao

     INDEXORD() é uma funçao de tratamento de banco de dados, que pode ser
     utilizada para determinar a posiçao do índice controlador na lista de
     arquivos de índices abertos pelo último comando USE...INDEX ou SET
     INDEX TO na área de trabalho corrente.  Geralmente é útil para gravar o
     último índice controlador para que ele possa ser recuperado depois.

     O padrao é que a funçao INDEXORD() opere na área de trabalho
     correntemente selecionada.  Pode-se fazê-la operar em uma área de
     trabalho nao selecionada se esta for especificada em uma expressao
     alias (veja o exemplo abaixo).

 Exemplos

       Este exemplo utiliza INDEXORD() para gravar a ordem
        corrente.  Após a mudança para uma nova ordem, ela usa o valor
        gravado para recuperar a ordem original:

        USE Customer INDEX Name, Serial NEW
        nOrder := INDEXORD()                            // Resulta: 1
        SET ORDER TO 2
        ? INDEXORD()                                    // Resulta: 2
        SET ORDER TO nOrder
        ? INDEXORD()                                    // Resulta: 1

       O exemplo a seguir utiliza uma expressao alias para
        determinar o número de ordem do índice controlador em uma área de
        trabalho nao selecionada:

        USE Sales INDEX Salesman, CustNum NEW
        USE Customer INDEX Name, Serial NEW
        ? Sales->(INDEXORD())                           // Resulta: 1

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: INDEXKEY() INDEX SET INDEX SET ORDER USE