Histórico da Página

Sintaxe

ALLTRIM( <expressão caracter> )

Propósito

Remove os espaços em branco do início e do fim de uma cadeia de caracteres.

Argumentos

< expressão caracter >

Define a cadeia de caracteres cujos espaços em branco serão eliminados.

Dicas

O inverso das funções ALLTRIM(), LTRIM() e RTRIM() são as funções PADC(), PADR() e PADL(), respectivamente, que automaticamente centralizam, alinham à direita ou à esquerda cadeias de caracteres por meio da adição de caracteres, em geral espaços em branco.

Exemplos

O exemplo abaixo cria uma cadeia de caracteres com espaços em branco à direita e à esquerda, e depois os remove com a função ALLTRIM():

LOCAL cString := SPACE(10) + "Totvs" + SPACE(10)

LEN(cString)                                // Resulta: 25

LEN(ALLTRIM(cString))              // Resulta: 5

cNome := “     AdvPL     “

MSGALERT(“***” + cNome + “***”)                           // Mostra ***     AdvPL     ***

// Elimina-se os espaços em branco existentes no início e no fim da cadeia de caracteres AdvPL

MSGALERT(“***” + ALLTRIM(cNome) + “***”)         // Mostra ***AdvPL ***

MSGALERT(LEN(cNome))                            // Resulta 15

MSGALERT(LEN(ALLTRIM(cNome)))          // Resulta 5