Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

AllTrim

AllTrim( <cText> ) --> cRet

Remove espaços das extremidades de uma string.

AllTrimAdvPL
01 · VISÃO GERAL

Visão geral

AllTrim devolve uma nova string sem os espaços à esquerda e à direita, preservando os espaços internos. A referência oficial também informa retorno vazio para argumento que não seja caractere; isso não é conversão de números para texto. Para remover apenas uma extremidade, compare LTrim e RTrim. A variável original só muda se você atribuir o resultado a ela. (Ref. 1)

02 · SINTAXE

Sintaxe

AllTrim( <cText> ) --> cRet

Parâmetros

cText
QualquerObrigatório

Texto a aparar; observe a regra documentada para outros tipos.

Retorno

Caractere: texto sem espaços nas extremidades; entrada não caractere resulta em string vazia segundo o TDN.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "TOTVS.ch"

User Function EdTrim()
    Local cTexto := "  Ana  Silva  "
    // Colchetes tornam visiveis os limites do resultado.
    ConOut("[" + AllTrim(cTexto) + "]")
    // AllTrim nao converte o numero em texto.
    ConOut("[" + AllTrim(42) + "]")
Return Nil
Resultado esperado

Resultados esperados: [Ana Silva] e []. O espaço duplo interno permanece. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Verificar o tipo antes de normalizar dados quando string vazia possa esconder uma entrada inválida. Não presumir remoção de qualquer caractere Unicode de espaçamento.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. AllTrim. Frameworksp/TDN. Consulta em 2026-10-24.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha