Função ALLTRIM( )

Retorna uma cadeia com os espaços iniciais e finais removidos da cadeia de entrada.

Sintaxe

ALLTRIM(cadeia)

Parâmetros

Nome Tipo Descrição
cadeia caractere

O campo, a expressão ou o valor literal do qual os espaços à esquerda e à direita devem ser removidos.

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna "Salvador":

ALLTRIM("   Salvador   ")

Retorna "São Paulo":

ALLTRIM("   São Paulo   ")

Exemplos avançados

Concatenação de campos de caracteres

Use ALLTRIM( ) para eliminar espaços durante a concatenação de campos de caracteres, como campos de nome e sobrenome, para que o campo resultante não contenha vários espaços em branco entre os valores concatenados.

DEFINE FIELD Nome_Completo COMPUTED ALLTRIM(Nome) + " " + ALLTRIM(Sobrenome)

Removendo espaços contínuos

Espaços contínuos não são removidos pela função ALLTRIM( ).

Se for necessário remover espaços contínuos à esquerda ou à direita, você pode criar um campo calculado usando a expressão:

DEFINE FIELD Descrição_limpa COMPUTED ALLTRIM(REPLACE(Descrição; CHR(160); CHR(32)))

A função REPLACE( ) substitui todos os espaços contínuos por espaços regulares e ALLTRIM( ) remove todos os espaços regulares à esquerda ou à direita.

Observações

Como funciona?

A função ALLTRIM( ) remove os espaços à esquerda e à direita de uma cadeia. Os espaços dentro da cadeia não são removidos.

Funções relacionadas

Use a função LTRIM( ) se você deseja remover apenas os espaços iniciais de uma cadeia, ou a função TRIM( ) se você deseja remover apenas os espaços finais.