Fundamentos do ADVPL

Asc em ADVPL — Como Obter o Código ASCII de um Caractere
Manipulação de String

Asc em ADVPL — Como Obter o Código ASCII de um Caractere

3 minutos No desenvolvimento Protheus, muitas vezes precisamos realizar validações de baixo nível, como identificar caracteres especiais, tratar quebras de linha ou validar a entrada de dados em campos de texto. A função Asc em ADVPL é a ferramenta nativa para retornar o valor numérico (código ASCII) de um caractere, sendo um conceito base em Fundamentos do ADVPL.   Neste guia prático, você aprenderá a sintaxe da função Asc, como ela se comporta com strings de múltiplos caracteres e como utilizá-la em conjunto com Continue lendo→

cValToChar em ADVPL — Como Converter Tipos de Dados para Caractere
Conversão de Dados

cValToChar em ADVPL — Como Converter Tipos de Dados para Caractere

3 minutos   No desenvolvimento Protheus, a conversão de tipos de dados é uma tarefa obrigatória. Muitas vezes precisamos exibir o conteúdo de uma variável numérica, lógica ou de data em uma mensagem para o usuário ou gravá-la em um arquivo de texto. A função cValToChar em ADVPL é a ferramenta mais versátil para isso, pois permite converter diversos tipos de dados para String de forma simplificada, sendo um pilar em Fundamentos do ADVPL.   Neste guia prático, você aprenderá a sintaxe da função Continue lendo→

Adicionando um Elemento em um Array com aAdd em ADVPL
Manipulação de Array

Adicionando um Elemento em um Array com aAdd em ADVPL

2 minutos A função aAdd em ADVPL adiciona um novo elemento no final de um array, aumentando o seu tamanho. O conteúdo do novo elemento será o resultado fornecido pela expressão. Ela é uma das funções de manipulação de array em ADVPL. *Caso a expressão não seja especificada, será atribuído o valor NIL ao novo elemento.   Sintaxe: aAdd( < aDest >, < xExpr > )   Parâmetros:     Retorno:   A função aAdd simplifica alguma situações, por exemplo, nós poderíamos ter a seguinte Continue lendo→

aSize em ADVPL — Como Alterar o Tamanho de um Array no Protheus
Manipulação de Array

aSize em ADVPL — Como Alterar o Tamanho de um Array no Protheus

4 minutos No desenvolvimento Protheus, trabalhar com coleções de dados exige flexibilidade. Muitas vezes, iniciamos um processo com um array de tamanho fixo, mas precisamos expandi-lo para comportar novos registros ou reduzi-lo para otimizar a memória. A função aSize em ADVPL é a ferramenta nativa para realizar esse redimensionamento, sendo um conceito fundamental em Manipulação de Array.   Neste guia prático, você aprenderá como utilizar a aSize para aumentar ou diminuir arrays, entendendo o comportamento do sistema com valores nulos e descarte de elementos. Continue lendo→

Str em ADVPL — Como Converter Número em String
Conversão de Dados

Str em ADVPL — Como Converter Número em String

3 minutos No dia a dia do desenvolvedor Protheus, a conversão de tipos de dados é uma das tarefas mais recorrentes. Seja para exibir um valor numérico em uma mensagem de alerta ou para concatenar um código com uma descrição, você precisará transformar números em texto. A função Str em ADVPL é a ferramenta nativa para essa finalidade, sendo um pilar essencial em Fundamentos do ADVPL.   Neste guia objetivo, vamos entender como a Str funciona, seus parâmetros de tamanho e decimais, e como Continue lendo→

Convertendo uma String Formatada(aaaammdd) para Data com SToD em ADVPL
Conversão de Dados

Convertendo uma String Formatada(aaaammdd) para Data com SToD em ADVPL

1 minuto A função SToD  em ADVPL converte uma String formatada(aaaammdd) para o tipo de dado Data no formato americano de mês, dia e ano(mm/dd/aa). Ela é uma das funções para conversão de tipo de dados em ADVPL. É o inverso da função DToS. Sintaxe: SToD(cData)   Argumento(s):   Retorno:   Exemplo: No exemplo abaixo utilizamos a função SToD e informamos como parâmetro a função a string “20230711” e o retorno é uma data no formato americano mês, dia e ano mm/dd/aa. Exemplo da Continue lendo→

DToS em ADVPL — Como Converter Data para String Formatada
Conversão de Dados

DToS em ADVPL — Como Converter Data para String Formatada

3 minutos No desenvolvimento Protheus, a manipulação de datas exige precisão, especialmente quando precisamos criar chaves de busca ou ordenar registros em arquivos temporários. A função DToS em ADVPL é a ferramenta nativa para converter uma variável do tipo Data para uma String no formato AAAAMMDD. Diferente da função DTOC, que segue o padrão local (DD/MM/AA), a DToS garante que a ordenação alfabética coincida com a cronológica, um conceito base em Fundamentos do ADVPL. este guia objetivo, você aprenderá a sintaxe da função DToSe Continue lendo→

CToD em ADVPL — Como Converter String para Data no Protheus
Conversão de Dados

CToD em ADVPL — Como Converter String para Data no Protheus

3 minutos No desenvolvimento Protheus, lidar com datas é uma tarefa constante. Muitas vezes, recebemos informações de data em formato de texto (String), como “12/07/2024”, mas para realizar cálculos — como somar dias ou comparar prazos — precisamos que esse dado seja do tipo Data. A função CToD em ADVPL (Character to Date) é a ferramenta nativa para realizar essa transformação de forma simples e eficiente, sendo um conceito base em Fundamentos do ADVPL.   O que é a função CToD e para que Continue lendo→

Tipos de Dados ADVPL — O Guia Completo para Desenvolvedores
Tipos de Dados

Tipos de Dados ADVPL — O Guia Completo para Desenvolvedores

8 minutos Entender os Tipos de Dados ADVPL é o primeiro passo para escrever códigos robustos e eficientes no Protheus. A linguagem ADVPL é conhecida por sua tipagem dinâmica, o que significa que uma variável não precisa ter seu tipo declarado rigidamente e pode mudar de conteúdo durante a execução. No entanto, para realizar cálculos, manipulações de texto ou controle de datas, você precisa dominar como o sistema trata cada informação.   Neste guia prático, vamos explorar os tipos de dados primários do Protheus, Continue lendo→

Val em ADVPL — Como Converter String para Numérico
Conversão de Dados

Val em ADVPL — Como Converter String para Numérico

3 minutos Você já passou pela situação de tentar realizar um cálculo matemático no Protheus e receber um erro de “type mismatch” porque um dos valores estava como caractere? Esse é um cenário extremamente comum, especialmente quando lemos dados de arquivos externos, APIs ou campos de texto. A função Val em ADVPL é a ferramenta nativa e essencial para resolver esse problema, permitindo a conversão direta de strings em valores numéricos. Dominar essa função é um passo obrigatório para quem está explorando os Fundamentos Continue lendo→

StrZero em ADVPL — Como Formatar Zeros à Esquerda
Conversão de Dados

StrZero em ADVPL — Como Formatar Zeros à Esquerda

2 minutos No desenvolvimento de rotinas no ERP Protheus, a padronização de códigos e documentos é um requisito constante. Seja para gerar uma chave de nota fiscal ou formatar um código de produto, a função StrZero em ADVPL é a ferramenta nativa essencial para converter números em strings com preenchimento fixo, sendo um pilar fundamental de Fundamentos do ADVPL.   Neste guia objetivo, você aprenderá a dominar a sintaxe da StrZero e como aplicá-la na Conversão de Dados para garantir a integridade das suas Continue lendo→

AllTrim em ADVPL — Como Remover Espaços de Strings
Manipulação de String

AllTrim em ADVPL — Como Remover Espaços de Strings

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 Continue lendo→