FIND*
 Procura num índice através de um valor chave especificado
------------------------------------------------------------------------------

 Sintaxe

     FIND <xcStringBusca>

 Argumentos

     <xcStringBusca> é o todo ou parte da chave de indexaçao do registro
     a ser pesquisado e pode ser especificado por um string, ou seja, uma
     cadeia de caracteres, ou por uma expressao caractere entre parênteses.
     Se for especificada uma expressao ao invés de um string, o comando FIND
     opera da mesma forma que o comando SEEK.

 Descriçao

     O comando FIND é um comando de compatibilidade que pesquisa um índice
     pela primeira chave que seja igual ao conjunto de caracteres
     especificado e posiciona o ponteiro de registros no registro
     correspondente.  Ele faz isso procurando-o no índice de controle que
     começa com a primeira chave e continua até que uma correspondência
     perfeita seja encontrada ou haja um valor chave maior do que o
     argumento de procura.  Caso haja a correspondência, o ponteiro de
     registro é posicionado no número do registro encontrado no índice.

     Se o comando SOFTSEEK estiver em OFF (o padrao) e o comando FIND nao
     encontrar um registro, o ponteiro de registro é posicionado na funçao
     LASTREC() + 1, a funçao EOF() retorna valor verdadeiro (.T.), e a
     funçao FOUND() retorna valor falso (.F.).  Caso o comando SOFTSEEK
     esteja em ON, o ponteiro de registro é posicionado no registro que
     tiver o valor da primeira chave maior do que o argumento de pesquisa, e
     a funçao FOUND() retorna valor falso (.F.).  Nesse caso, a funçao EOF()
     somente retorna valor verdadeiro (.T.) se nao houver chaves no índice
     que sejam maiores do que o argumento de pesquisa.

     FIND é um comando de compatibilidade e portanto nao é recomendado. Ele
     é totalmente superado pelo comando SEEK.

 Exemplos

     Estes exemplos mostram resultados do comando FIND simples:

     USE Sales NEW
     INDEX ON Branch TO Branch

     ? TYPE(Branch)                      // Resulta: C
     ? LASTREC()                         // Resulta: 84

     FIND ("500")
     ? FOUND(), EOF(), RECNO()           // Resulta: .F. .T. 85

     FIND 200
     ? FOUND(), EOF(), RECNO()           // Resulta: .T. .F. 5

     FIND "100"
     ? FOUND(), EOF(), RECNO()           // Resulta: .T. .F. 1

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

See Also: SEEK SET ORDER SET SOFTSEEK EOF() FOUND()