Tempo de leitura: 2 minutos
Se você trabalha com desenvolvimento no Protheus, em algum momento já precisou tratar strings removendo espaços em branco desnecessários.
A função AllTrim em ADVPL é uma das mais utilizadas para esse tipo de situação, permitindo limpar espaços à esquerda e à direita de forma simples e eficiente.
Neste artigo, você vai aprender como usar AllTrim no Protheus na prática, com exemplos reais e aplicações no dia a dia.
O que é AllTrim em ADVPL
A função AllTrim() é utilizada para remover espaços em branco no início e no final de uma string.
Ela é muito comum em cenários como:
- validação de campos
- tratamento de dados
- integração entre sistemas
- comparação de strings
Quando usar AllTrim no Protheus
Você deve utilizar AllTrim quando:
- precisar validar entradas do usuário
- trabalhar com dados importados
- evitar inconsistências em campos
- comparar strings com precisão
Como funciona o AllTrim
A função recebe uma string como parâmetro e retorna o valor sem espaços nas extremidades.
Sintaxe:
AllTrim(cTexto)
Parâmetro(s):
Retorno:
No exemplo abaixo utilizamos a função AllTrim e informamos como parâmetro à função o valor caractere ” ProtheusAdvpl “ com espaços tanto a esquerda como a direita e o retorno é uma string sem os espaços “ProtheusAdvpl”.
Exemplo da função Alltrim em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function fAllTrim
(Essa função tem por finalidade mostrar a função AllTrim em ADVPL)
@type Function
@author Adilio Costa
@since 08/07/2023
@version 1.0
@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function fAlltrim()
Local cTexto := " Portal ProtheusAdvpl "
Local cTexto2 := AllTrim(cTexto)
FWAlertInfo("O texto "+cTexto+" sem os espaços à esquerda e direita:"+cTexto2,"Função AllTrim")
Return
Resultado
PROTHEUS ADVPL
Explicação do código:
- Texto: variável contendo espaços
- AllTrim: remove espaços à esquerda e à direita
- FWAlertInfo: exibe o resultado
⚠️ Erros comuns ao usar AllTrim
❌ Não armazenar o retorno
AllTrim não altera a variável original automaticamente.
❌ Usar com variável inválida
Sempre garanta que o valor seja uma string.
❌ Não tratar valores nulos
Pode gerar inconsistências no sistema.
Conclusão
A função AllTrim em ADVPL é essencial para garantir qualidade e consistência nos dados manipulados no Protheus.
Dominar esse tipo de função é um passo importante para evoluir como desenvolvedor ADVPL e evitar problemas comuns no dia a dia.
Link(s) de Referência(s):https://tdn.totvs.com/pages/viewpage.action?pageId=23889114
👉 Quer dominar os fundamentos do ADVPL no Protheus?
Conheça o curso Programação ADVPL I o curso mais completo do mercado do mercado.