Tempo de leitura: 3 minutos
No desenvolvimento em Protheus, lidar com espaços em branco indesejados é um desafio constante, especialmente em integrações ou validações de campos. A função AllTrim em ADVPL é a solução nativa para “limpar” strings, sendo um dos conceitos mais fundamentais em Fundamentos do ADVPL.
Neste guia objetivo, você aprenderá como a AllTrim funciona e como aplicá-la para garantir a integridade dos dados em suas customizações.
O que é a função AllTrim e para que serve?
A função AllTrim em ADVPL remove simultaneamente todos os espaços em branco localizados no início (à esquerda) e no final (à direita) de uma string. Ela é indispensável para garantir que comparações de texto e gravações em banco de dados não contenham caracteres invisíveis que possam causar erros de busca.
Diferente da Str, que muitas vezes adiciona espaços para completar um tamanho, a AllTrim é usada justamente para eliminá-los após uma conversã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
Para dominar este conceito em cenários complexos, com aulas em vídeo e suporte especializado, conheça o Portal ProtheusAdvpl. Lá, exploramos a fundo a arquitetura por trás desta função e suas aplicações em grandes projetos de integração.
Quando usar AllTrim no Protheus
Você deve utilizar a AllTrim sempre que:
- Precisar comparar duas strings (ex: AllTrim(cVar1) == AllTrim(cVar2)).
- For gravar dados em campos de tabelas customizadas para evitar espaços fantasmas.
- Estiver trabalhando com o retorno da função Str.
Conclusão
A função AllTrim em ADVPL é uma ferramenta básica, mas vital para a qualidade do código no Protheus. Ela evita inconsistências em buscas e garante que a interface do usuário exiba apenas o conteúdo relevante. Ao utilizá-la corretamente, você eleva o nível de precisão das suas rotinas de Conversão de Dados.
Links de referência(s):
Conteúdos relacionados
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.
Conheça o curso Programação ADVPL I o curso mais completo do mercado do mercado.
