Funções de transformação matemática simples

Use funções de transformação matemática simples para executar cálculos matemáticos básicos em cápsulas de dados numéricos.

As funções de transformação matemática simples exigem uma cápsula de dados de entrada Array.Number, Array.Integer ou Array.Decimal. Certifique-se de usar a entrada correta tipo de cápsula de dados ao aplicar funções de transformação matemática simples. Se uma função de transformação matemática simples for aplicada a um tipo de dados inadequado, os dados não serão transformados no tempo de execução e o valor de entrada será retornado. Para obter mais informações sobre como confirmar os valores de tempo de execução do fluxo, consulte Teste um fluxo .

Valor absoluto

Uma função matemática que retorna a distância de zero para qualquer número real. Um valor absoluto é sempre um valor positivo ou zero.

Cápsula de dados de entrada	Cápsula de dados de saída
Número, Inteiro ou Decimal	Número como o valor absoluto do número de entrada

Figura 1. Exemplo

• Entrada: -3
• Saída: 3

Adicionar

Adiciona o valor fornecido à entrada.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Número, Inteiro ou Decimal	Número a ser adicionado.	Número como a adição do valor de entrada pelo parâmetro.

Figura 2. Exemplo

• Entrada: 12
• Parâmetro: 4
• Saída: 16

Média

Retorna o valor médio dos elementos na matriz de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Array.Number, Array.Integer ou Array.Decimal	Número como o valor médio da matriz de entrada.

Figura 3. Exemplo

• Entrada: [10, 30, 20]
• Saída: 20

Contagem

Retorna o número de elementos na matriz de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Matriz.Número, Matriz.Inteiro, Matriz.Decimal, Matriz.Objeto, Matriz.Cadeia de caracteres, ou Matriz.booliano	Número de elementos na matriz de entrada

Figura 4. Exemplo

• Entrada: [2, 10, 30]
• Saída: 3

Dividir

Divide o valor de entrada por um determinado valor.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Número, Inteiro ou Decimal	Número pelo qual dividir o valor de entrada.	Número como a divisão do valor de entrada pelo parâmetro.

Figura 5. Exemplo

• Entrada: 12
• Parâmetro: 4
• Saída: 3

Máx

Retorna o valor mais alto encontrado na matriz de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Array.Number, Array.Integer ou Array.Decimal	Número como o valor mais alto na matriz de entrada

Figura 6. Exemplo

• Entrada: [1, -5, 20, 6]
• Saída: 20

Mediana

Retorna o valor médio dos elementos na matriz de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Array.Number, Array.Integer ou Array.Decimal	Número como o valor mediano da matriz de entrada.

Figura 7. Exemplo

• Entrada: [10, 30, 15]
• Saída: 15

Mín

Retorna o valor mais baixo encontrado na matriz de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Array.Number, Array.Integer ou Array.Decimal	Número como o menor valor na matriz de entrada

Figura 8. Exemplo

• Entrada: [1, -5, 20, 6]
• Saída: -5

Multiplicar

Multiplica o valor de entrada por um determinado valor.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Número, Inteiro ou Decimal	Número a ser multiplicado.	Número como multiplicação do valor de entrada pelo parâmetro.

Figura 9. Exemplo

• Entrada: 12
• Parâmetro: 4
• Saída: 48

Potência

Retorna o valor do valor de entrada elevado à potência de um determinado valor.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Número, Inteiro ou Decimal	Número como o expoente da potência.	Número como a potência do valor de entrada para o parâmetro.

Figura 10. Exemplo

• Entrada: 2
• Parâmetro: 3
• Saída: 8

Arredondar

Uma função matemática que aproxima um valor numérico com base em regras de arredondamento e uma posição de dígito. A função arredonda para cima adicionando um ao dígito a ser arredondado e substituindo todos os dígitos à direita por zeros.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Número, Inteiro ou Decimal	Number of Digits - Um número inteiro positivo que especifica a posição do dígito a ser arredondado a partir da esquerda	Número como o valor arredondado do número de entrada

Figura 11. Exemplo

• Entrada: 194
• Parâmetro: 2
• Saída: 190

Nota:

A função usa o dígito à direita do dígito do parâmetro para arredondar para cima ou para baixo. Se o dígito à direita tiver um valor de zero a quatro, a função arredondará para baixo. Se o dígito à direita tiver um valor de cinco a nove, a função arredondará para cima. Se não houver dígito à direita, a função arredondará para baixo.

Raiz quadrada

Uma função matemática que calcula um número positivo que, quando multiplicado por si só, produz o valor de entrada. O valor de entrada deve ser um número real positivo.

Cápsula de dados de entrada	Cápsula de dados de saída
Número, Inteiro ou Decimal	Número como a raiz quadrada do número de entrada

Figura 12. Exemplo

• Entrada: 16
• Saída: 4

Subtrair

Subtrai o valor fornecido da entrada.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Número, Inteiro ou Decimal	Número a ser subtraído do valor de entrada.	Número como a subtração do valor de entrada pelo parâmetro.

Figura 13. Exemplo

• Entrada: 12
• Parâmetro: 4
• Saída: 8

Soma

Retorna a soma de todos os valores na matriz de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Array.Number, Array.Integer ou Array.Decimal	Número como uma soma de todos os valores na matriz de entrada

Figura 14. Exemplo

• Entrada: [1, -5, 20, 6]
• Saída: 22

Para Corrigido

Trunca um número flutuante para o número especificado de casas decimais.

Cápsula de dados de entrada	Parâmetro	Cápsula de dados de saída
Número - Número decimal antes do truncamento.	Número de dígitos - Número que especifica o número de casas decimais a serem truncados.	Número - Número decimal após o truncamento.

Figura 15. Exemplo

• Entrada: 1,93456
• Parâmetro: 2
• Saída: 1,93