Introdução
A linguagem de programação ADVPL (Advanced Protheus Language) é amplamente utilizada no desenvolvimento de sistemas empresariais, especialmente no contexto do ERP Protheus, da empresa TOTVS. Uma das principais características dessa linguagem é a sua extensa biblioteca de funções padrão, que oferecem uma ampla gama de recursos para os desenvolvedores. Neste glossário, iremos explorar algumas das principais funções padrão ADVPL, fornecendo uma visão detalhada de cada uma delas.
1. ALLTRIM()
A função ALLTRIM() é utilizada para remover os espaços em branco tanto no início quanto no final de uma string. Ela percorre toda a string e remove todos os espaços em branco desnecessários, deixando apenas o conteúdo relevante. Essa função é muito útil quando se trabalha com dados vindos de fontes externas, como arquivos de texto ou bancos de dados, onde podem ocorrer espaços em branco indesejados.
2. AT()
A função AT() é utilizada para buscar a posição de uma substring dentro de uma string. Ela recebe dois parâmetros: a substring a ser buscada e a string onde a busca será realizada. A função retorna a posição da primeira ocorrência da substring dentro da string, ou zero caso a substring não seja encontrada. Essa função é muito útil para realizar buscas em strings e manipular dados de forma mais precisa.
3. CHR()
A função CHR() é utilizada para obter o caractere correspondente a um determinado código ASCII. Ela recebe como parâmetro o código ASCII do caractere desejado e retorna o caractere correspondente. Essa função é útil quando se trabalha com manipulação de caracteres e é necessário obter um caractere específico com base no seu código ASCII.
4. DTOC()
A função DTOC() é utilizada para converter uma data em formato de data/hora para o formato de data. Ela recebe como parâmetro uma data em formato de data/hora e retorna apenas a parte da data, no formato DD/MM/AAAA. Essa função é muito útil quando se trabalha com manipulação de datas e é necessário extrair apenas a parte da data de uma data/hora completa.
5. EMPTY()
A função EMPTY() é utilizada para verificar se uma variável está vazia. Ela recebe como parâmetro a variável a ser verificada e retorna verdadeiro caso a variável esteja vazia, ou falso caso contrário. Essa função é útil para realizar validações e evitar erros ao manipular variáveis que podem estar vazias.
6. EVAL()
A função EVAL() é utilizada para avaliar uma expressão em ADVPL. Ela recebe como parâmetro uma string contendo a expressão a ser avaliada e retorna o resultado da avaliação. Essa função é útil quando se trabalha com expressões dinâmicas e é necessário avaliar uma expressão em tempo de execução.
7. GETENV()
A função GETENV() é utilizada para obter o valor de uma variável de ambiente do sistema operacional. Ela recebe como parâmetro o nome da variável de ambiente e retorna o valor correspondente. Essa função é útil quando se precisa obter informações do ambiente de execução, como o diretório de instalação do sistema ou o nome do usuário logado.
8. LEN()
A função LEN() é utilizada para obter o tamanho de uma string. Ela recebe como parâmetro a string a ser medida e retorna o número de caracteres da string. Essa função é útil quando se precisa realizar operações que dependem do tamanho de uma string, como a criação de loops ou a manipulação de substrings.
9. LOWER()
A função LOWER() é utilizada para converter uma string para letras minúsculas. Ela recebe como parâmetro a string a ser convertida e retorna a mesma string, porém com todas as letras em minúsculo. Essa função é útil quando se precisa realizar comparações de strings sem considerar o case das letras.
10. STR()
A função STR() é utilizada para converter um valor numérico em uma string. Ela recebe como parâmetro o valor numérico a ser convertido e retorna uma string contendo a representação do valor numérico. Essa função é útil quando se precisa manipular valores numéricos como strings, por exemplo, para exibir valores em relatórios ou para realizar concatenações de strings com valores numéricos.
11. SUBSTR()
A função SUBSTR() é utilizada para extrair uma substring de uma string. Ela recebe três parâmetros: a string original, a posição inicial da substring e o tamanho da substring a ser extraída. A função retorna a substring extraída da string original. Essa função é útil quando se precisa manipular partes específicas de uma string, como extrair um nome de arquivo de um caminho completo.
12. TRANSFORM()
A função TRANSFORM() é utilizada para converter um valor numérico em uma string formatada. Ela recebe como parâmetro o valor numérico a ser convertido e retorna uma string contendo a representação formatada do valor numérico. Essa função é útil quando se precisa exibir valores numéricos em um formato específico, como valores monetários ou datas formatadas.
13. UPPER()
A função UPPER() é utilizada para converter uma string para letras maiúsculas. Ela recebe como parâmetro a string a ser convertida e retorna a mesma string, porém com todas as letras em maiúsculo. Essa função é útil quando se precisa realizar comparações de strings sem considerar o case das letras.
