AllTrim

Remove espacos em branco no inicio e fim de uma string. Funcao essencial pra comparar strings vindas do banco.

Assinatura: AllTrim(cString) -> cString

Retorna: Character

AllTrim() remove os espacos das duas extremidades de uma string. E uma das funcoes mais usadas em AdvPL — campos Character em Protheus vem preenchidos com espacos ate o tamanho declarado na SX3, e voce quase sempre quer comparar so o conteudo util.

Sintaxe

cResultado := AllTrim(cString)

Exemplo

cNome := AllTrim("  Joao Silva  ")
// Resultado: "Joao Silva"

// Uso classico ao ler do banco:
cCpf := AllTrim(SA1->A1_CGC)  // remove os espacos do campo CGC

// Combinado com Upper pra busca case-insensitive:
cBusca := Upper(AllTrim(cFiltro))

Quando usar

Sempre que comparar strings vindas de campos da SX3 com Character
Antes de exibir conteudo em telas/relatorios
Combinado com Upper()/Lower() pra padronizar buscas

Pegadinhas

AllTrim() nao remove espacos no MEIO da string. Pra isso use StrTran(cStr, " ", "")
Existem variantes: LTrim() remove so a esquerda, RTrim() so a direita

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`cString`	Character	sim	String com possiveis espacos nas extremidades

Exemplos

Uso basico

cNome := AllTrim("  Joao  ")  // "Joao"

Comparacao de campos do banco

If AllTrim(SA1->A1_NOME) == cBusca
    // achou
EndIf