Converte e retorna a forma complementada da expressão string especificada.

Sintaxe

Descend( < cString > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cString

caractere

Indica a seqüência de caracteres que será analisada.

X

 

Retorno

Nome

Tipo

Descrição

cRet

caractere

Retorna a string especificada como parâmetro de uma forma complementada. Um DESCEND() de CHR(0) sempre retorna CHR(0).

Observações

Normalmente, esta função é utilizada para criar indexadores em ordem decrescente.

Exemplos

Exemplo 1
//Exemplo 1
  Descend(cDesc)

------------------------------------------------------------------

//Exemplo 2
//Este exemplo utiliza DESCEND() em uma expressao INDEX para criar um índice de datas de ordem descendente: 
  USE Sales NEWINDEX ON DESCEND(DTOS(OrdDate)) TO SalesDate
//Depois, DESCEND() pode ser utilizado para fazer uma pesquisa (SEEK) no índice descendente: 
  DbSEEK(DESCEND(DTOS(dFindDate)))
//Observação : Faz-se necessária a conversão da Data para String m através da função DTOS(), pois a função DESCEND apenas trabalha com Strings.

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

  • Sem rótulos

2 Comentários

  1. Também é possível utilizar em mais de um campo da chave exemplo:

    XXX_CODIGO+XXX_VALOR+DESCEND(XXX_DATA+XXX_HORA)

     

     

     

  2. Quando tem tratamento numérico deve primeiro converter em texto pela função Str

    D2_FILIAL + D2_CLIENTE + D2_LOJA + DESCEND(Str(D2_TOTAL,14,2))