Funções

As funções são rotinas incorporadas que aceitam um número específico de parâmetros e retornam um único valor. Use funções para manipular conteúdo e variáveis de campo usadas em comandos.

Nota

As funções não modificam dados de campos. Elas geram e retornam um novo valor com base em um cálculo ou algoritmo que usa dados de campos ou variáveis como entrada. Use o valor retornado pela função como entrada para um comando.

Sintaxe da função

As funções iniciam com o nome da função, seguido imediatamente por um parêntese de abertura, uma lista de zero ou mais valores passados para a função como argumentos separados por ponto e vírgula e um parêntese de fechamento.

Exemplo

A função BETWEEN(valor; mín; máx) recebe três argumentos e retorna verdadeiro se o valor está no intervalo ou falso se o valor está fora do intervalo:

  • valor – a expressão ou valor a testar
  • mín – o valor mínimo do intervalo
  • máx – o valor máximo do intervalo
BETWEEN(valor; 500; 5000)

Argumentos da função

Um argumento de uma função é um valor de entrada específico passado à função.

Os argumentos da função são passados à função por meio de uma lista de argumentos. Essa lista contém valores literais, variáveis ou expressões avaliadas como valores do tipo de dados parâmetro, separados por vírgula. Para obter mais informações sobre como trabalhar com tipos de dados, consulte Tipos de dados.

Nota

Se o projeto opera com formatos de número europeus, ou se você está criando scripts que são portáteis entre regiões, separe os argumentos da função com um espaço, em vez de vírgula, a menos que esteja passando um valor numérico com sinal. As funções que aceitam valores numéricos com sinal exigem um delimitador específico.

Funções vs. comandos

A distinção entre comandos e funções é sutil, mas essencial para usar o ACLScript:

Funções Comandos
Usam campos, valores ou registros como entrada e geram um novo valor, que é retornado. Usam tabelas como entrada e geram novos registros e tabelas.
Usadas em expressões, campos calculados, valores de parâmetros de comando, variáveis e filtros para auxiliar e modificar a execução do comando. Usados para analisar dados, importar dados e gerar resultados.
Não podem ser uma etapa independente em um script. Podem ser uma etapa independente em um script.

[ Voltar ao início ]

Guia de scripting do ACL 14.1