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 o tipo de cápsula de dados de entrada correto 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 impróprio, 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 Testar um fluxo.

Valor absoluto

Uma função matemática que retorna a distância do 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
Matriz.Número, Matriz.Inteiro ou Matriz.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
Array.Number, Array.Integer, Array.Decimal, Array.Object, Array.String ou Array.Boolean	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áximo(a)

Retorna o valor mais alto encontrado na matriz de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Matriz.Número, Matriz.Inteiro ou Matriz.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
Matriz.Número, Matriz.Inteiro ou Matriz.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
Matriz.Número, Matriz.Inteiro ou Matriz.Decimal	Número como o valor mais baixo 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 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, começando à 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 será arredondada para baixo. Se o dígito à direita tiver um valor de cinco a nove, a função será arredondada para cima. Se não houver nenhum dígito à direita, a função será arredondada para baixo.

Raiz quadrada

Uma função matemática que calcula um número positivo que, multiplicado por ele mesmo, 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
Matriz.Número, Matriz.Inteiro ou Matriz.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 truncadas.	Número - Número decimal após o truncamento.

Figura 15. Exemplo

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