Chamadas de função integradas

O FormCalc é compatível com um grande conjunto de funções integradas com uma ampla variedade de capacidades. Os nomes das funções não diferenciam maiúsculas de minúsculas, mas ao contrário de palavras-chave, o FormCalc não reserva os nomes das funções. Isso significa que cálculos em formulários com objetos cujos nomes coincidem com os nomes das funções do FormCalc não entram em conflito.

As funções podem ou não exigir algum conjunto de argumentos para execução e retorno de um valor. Muitas funções têm argumentos que são opcionais, significando que depende de você escolher se o argumento é necessário para a situação específica.

O FormCalc avalia todos os argumentos de função na ordem, iniciando com o argumento líder. Se for feita uma tentativa de passar menos do que o número necessário de argumentos para uma função, a função irá gerar uma exceção de erro.

Cada função espera cada argumento em um formato específico, como um literal de número ou de string. Se o valor de um argumento não corresponder ao que uma função espera, o FormCalc converterá o valor. Por exemplo:

    Len(35)

A função Len espera na verdade uma string de literal. Nesse caso, o FormCalc converte o argumento do número 35 para a string “35” e a função avalia para 2.

No entanto, no caso de um literal de string para literal de número, a conversão não é tão simples. Por exemplo:

    Abs("abc")

A função Abs espera um literal de número. O FormCalc converte o valor de todos os literais de string como 0. Isso pode causar problemas em funções onde um valor de 0 força um erro, como no caso da função Apr.

Alguns argumentos de função exigem apenas valores integrais; em tais casos, os argumentos passados são sempre promovidos para inteiros truncando a parte fracional.

A seguir, é apresentado um resumo das principais propriedades de funções integradas:

  • Os nomes de função integrada não diferenciam maiúsculas de minúsculas.

  • As funções integradas são predefinidas, mas seus nomes não são palavras reservadas. Isso significa que a função integrada Máx nunca entra em conflito com um objeto, propriedade de objeto ou método de objeto nomeado Max.

  • Muitas das funções integradas têm um número obrigatório de argumentos, que pode ser seguido por um número opcional de argumentos.

  • Algumas funções integradas, Avg, Contagem, Máx, Min, Sum e Concat, aceitam um número indefinido de argumentos.

Para obter uma lista completa de todas as funções do FormCalc, consulte a Lista alfabética de funções.