Guia de Referência do Net.Data

Funções Matemáticas

Estes funções permitem que a maioria dos tipos de cálculos matemáticos sejam feitos.

• DTW_ADD

• DTW_DIVIDE

• DTW_DIVREM

• DTW_FORMAT

• DTW_INTDIV

• DTW_MULTIPLY

• DTW_POWER

• DTW_SUBTRACT

DTW_ADD

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Adiciona os valores de dois parâmetros.

Sintaxe

• @DTW_ADD(número1, número2, precisão, resultado)
• @DTW_rADD(número1, número2, precisão)

Parâmetros

Tabela 12. Parâmetros DTW_ADD

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número1	IN	Variável ou cadeia literal representando um número.
flutuante	número2	IN	Variável ou cadeia literal representando um número.
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	Variável que contém a soma do número1 e número2.

Exemplos

Exemplo 1:

@DTW_ADD(NUMB1, NUMB2, "2", resultado)

• Entrada: NUMB1 = "105", NUMB2 = "3"
• Retorna: resultado = "1.1E+2"

Exemplo 2:

@DTW_rADD("12",NUMB2,"5")

• Entrada: NUMB2 = "7.00"
• Retorna: "19.00"

DTW_DIVIDE

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Divide o valor do primeiro parâmetro pelo valor do segundo parâmetro.

Sintaxe

• @DTW_DIVIDE(número1, número2, precisão, resultado)
• @DTW_rDIVIDE(número1, número2, precisão)

Parâmetros

Tabela 13. Parâmetros DTW_DIVIDE

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número1	IN	Variável ou cadeia literal representando um número.
flutuante	número2	IN	Variável ou cadeia literal representando um número.
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	Variável que contém o resultado do número1 dividido pelo número2.

Exemplos

Exemplo 1:

@DTW_DIVIDE("8.0", NUMB2, resultado)

• Entrada: NUMB2 = "2"
• Retorna: resultado = "4"

Exemplo 2:

@DTW_rDIVIDE("1",NUMB2,"5")

• Entrada: "1", NUMB2 = "3"
• Retorna: "0.33333"

Exemplo 3:

@DTW_rDIVIDE(NUMB1,"2","5")

• Entrada: NUMB1 = "5"
• Retorna: "2.5"

DTW_DIVREM

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Divide o primeiro parâmetro pelo segundo parâmetro e retorna o restante. O sinal do restante, caso diferente de zero, é o mesmo daquele do primeiro parâmetro. Caso o resultado não possa ser expresso como um número inteiro, a operação está em erro e falha.

Sintaxe

• @DTW_DIVREM(número1, número2, precisão, resultado)
• @DTW_rDIVREM(número1, número2, precisão)

Parâmetros

Tabela 14. Parâmetros DTW_DIVREM

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número1	IN	Variável ou cadeia literal representando um número.
flutuante	número2	IN	Variável ou cadeia literal representando um número.
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	Variável que contém o restante do número1 dividido pelo número2.

Exemplos

Exemplo 1:

@DTW_DIVREM(NUMB1, NUMB2, resultado)

• Entrada: NUMB1 = "2.1", NUMB2 = "3"
• Retorna: resultado = "2.1"

Exemplo 2:

@DTW_rDIVREM("10",NUMB2)

• Entrada: NUMB2 = "0.3"
• Retorna: "0.1"

Exemplo 3:

@DTW_rDIVREM("3.6","1.3")

• Retorna: "1.0"

Exemplo 4:

@DTW_rDIVREM("-10","3")

• Retorna: "-1"

DTW_FORMAT

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Personaliza a formatação de um número. Caso apenas o parâmetro número seja especificado, o resultado é formatado somente se @DTW_rADD(número,"0") tiver sido executado. Caso qualquer outra opção seja especificada então o número é formatado de acordo com as seguintes regras:

• As opções antes e após descrevem quantos caracteres são usados para as partes inteira e decimal do resultado, respectivamente. Caso omita uma delas ou ambas, o número de caracteres utilizado para aquela parte é o quanto for necessário.

• Se antes não for grande o bastante para conter a parte de inteiros do número (mais o sinal para um número negativo), um erro ocorrerá. Se antes for maior do que o necessário para aquela parte, o número é preenchido com espaços em branco à esquerda. Se após não for do mesmo tamanho da parte decimal do número, o número é arredondado (ou estendido com zeros) para se adequar. Especificando 0 faz com que o número seja arredondado para um inteiro.

• Além disso, expp e expt controlam a parte exponencial do resultado. O expp define o número de casas para a parte do expoente; o padrão é se usar tantas quantas necessárias (podendo ser zero). O expt define o ponto trigger para uso da notação exponencial. O padrão é o valor padrão do parâmetro de precisão.

• Se expp for 0, nenhum expoente é fornecido, e o número é expresso na forma simples com zeros adicionados conforme necessário. Se expp não for grande o bastante para conter o expoente, um erro ocorre.

• Caso o número de casas necessárias para a parte inteira ou decimal exceda expt ou duas vezes expt, respectivamente, a notação exponencial é usada. Se expt for 0, a notação exponencial é sempre usada, a menos que o expoente seja 0. (Se expp for 0, este sobrepõe um valor 0 de expt.) Se o expoente for 0 quando um expp diferente de zero é especificado, expp+2 espaços em branco são fornecidos para a parte expoente do resultado. Se o expoente for 0 e expp não é especificado, a forma simples é usada.

Sintaxe

• @DTW_FORMAT(número, antes, após, expp, expt, precisão, resultado)
• @DTW_rFORMAT(número, antes, após, expp, expt, precisão)

Parâmetros

Tabela 15. Parâmetros DTW_FORMAT

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número	IN	Variável ou cadeia literal representando um número.
inteiro	antes	IN	Variável ou cadeia literal representando um número inteiro positivo. Esse é um parâmetro opcional. Para possuir parâmetros adicionais, é necessário fornecer uma cadeia nula ("").
inteiro	após	IN	Variável ou cadeia literal representando um número inteiro positivo. Esse é um parâmetro opcional. Para possuir parâmetros adicionais, é necessário fornecer uma cadeia nula ("").
inteiro	expp	IN	Variável ou cadeia literal representando um número inteiro positivo. Para possuir parâmetros adicionais, é necessário fornecer uma cadeia nula ("").
inteiro	expt	IN	Variável ou cadeia literal representando um número inteiro positivo. Para possuir parâmetros adicionais, é necessário fornecer uma cadeia nula ("").
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	Variável que contém o número com um arredondamento e formatação especificados.

Exemplos

Exemplo 1:

@DTW_FORMAT(NUMB, BEFORE,
resultado)

• Entrada: NUMB = "3", BEFORE = "4"
• Retorna: resultado= " 3"

Exemplo 2:

@DTW_FORMAT("1.73", "4", "0",
resultado)

• Retorna: resultado = " 2"

Exemplo 3:

@DTW_FORMAT("1.73", "4", "3", resultado)

• Retorna: resultado = " 1.730"

Exemplo 4:

@DTW_FORMAT(" - 12.73", "", "4", resultado)

• Retorna: resultado = "-12.7300"

Exemplo 5:

@DTW_FORMAT("12345.73", "", "", "2", "2", resultado)

• Retorna: resultado = "1.234573E+04"

Exemplo 6:

@DTW_FORMAT("1.234573", "",
"3", "", "0", resultado)

• Retorna: resultado = "1.235"

Exemplo 7:

@DTW_rFORMAT(" - 12.73")

• Retorna: " - 12.73"

Exemplo 8:

@DTW_rFORMAT("0.000")

• Retorna: "0"

Exemplo 9:

@DTW_rFORMAT("12345.73","","","3","6")

• Retorna: "12345.73"

Exemplo 10:

@DTW_rFORMAT("1234567e5","","3","0")

• Retorna: "123456700000.000"

Exemplo 11:

@DTW_rFORMAT("12345.73","","3","","0")

• Retorna: "1.235E+4"

DTW_INTDIV

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Divide o primeiro parâmetro pelo segundo parâmetro e retorna a parte inteira do resultado.

Sintaxe

• @DTW_INTDIV(número1, número2, precisão, resultado)
• @DTW_rINTDIV(número1, número2, precisão)

Parâmetros

Tabela 16. Parâmetros DTW_INTDIV

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número1	IN	Variável ou cadeia literal representando um número.
flutuante	número2	IN	Variável ou cadeia literal representando um número.
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	Variável que contém a parte inteira do número1 dividido pelo número2.

Exemplos

Exemplo 1:

@DTW_INTDIV(NUMB1, NUMB2,
resultado)

• Entrada: NUMB1 = "10", NUMB2 = "3"
• Retorna: resultado = "3"

Exemplo 2:

@DTW_rINTDIV("2",NUMB2)

• Entrada: NUMB2 = "3"
• Retorna: "0"

DTW_MULTIPLY

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Multiplica dois parâmetros.

Sintaxe

• @DTW_MULTIPLY(número1, número2, precisão, resultado)
• @DTW_rMULTIPLY(número1, número2, precisão)

Parâmetros

Tabela 17. Parâmetros DTW_MULTIPLY

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número1	IN	Variável ou cadeia literal representando um número.
flutuante	número2	IN	Variável ou cadeia literal representando um número.
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	Variável que contém o produto do número1 vezes o número2.

Exemplos

Exemplo 1:

@DTW_MULTIPLY(NUM1, NUMB2,
resultado)

• Entrada: NUMB1 = "4", NUMB2 = "5"
• Retorna: resultado = "20"

Exemplo 2:

@DTW_rMULTIPLY("0.9",NUMB2)

• Entrada: NUMB2 = "0.8"
• Retorna: "0.72"

DTW_POWER

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Eleva o primeiro parâmetro à potência do segundo parâmetro.

Sintaxe

• @DTW_POWER(número1, número2, precisão, resultado)
• @DTW_rPOWER(número1, número2, precisão)

Parâmetros

Tabela 18. Parâmetros DTW_POWER

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número1	IN	Variável ou cadeia literal representando um número.
flutuante	número2	IN	Variável ou cadeia literal representando um número.
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	Variável que contém o resultado do número1 elevado a potência do número2.

Exemplos

Exemplo 1:

@DTW_POWER(NUMB1, NUMB2,
resultado)

• Entrada: NUMB1 = "2", NUMB2 = "-3"
• Retorna: resultado = "0.125"

Exemplo 2:

@DTW_rPOWER("1.7", NUMB2,
precisão)

• Entrada: NUMB2 = "8", precisão = "5"
• Retorna: "69.758"

DTW_SUBTRACT

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Subtrai o valor do segundo parâmetro do valor do primeiro parâmetro.

Sintaxe

• @DTW_SUBTRACT(número1, número2, precisão, resultado)
• @DTW_rSUBTRACT(número1, número2, precisão)

Parâmetros

Tabela 19. Parâmetros DTW_SUBTRACT

Tipo de Dados	Parâmetro	Uso	Descrição
flutuante	número1	IN	Variável ou cadeia literal representando um número.
flutuante	número2	IN	Variável ou cadeia literal representando um número.
inteiro	precisão	IN	Variável ou cadeia literal representando um número inteiro positivo que especifica a precisão do resultado. O padrão é 9.
flutuante	resultado	OUT	A variável que contém a diferença entre o número1 e o número2.

Exemplos

Exemplo 1: Este exemplo mostra como comparar valores numéricos, que são cadeias no Net.Data.

@DTW_SUBTRACT(NUM1, NUMB2, comp)
%IF(comp > "0")
<P>$(NUM1) é maior que  $(NUM2).
%ENDIF

• Entrada: NUMB2 = "2.07"
• Retorna: "-0.77"

Exemplo 2:

@DTW_SUBTRACT(NUMB1, NUMB2,
resultado)

• Entrada: NUMB1 = "1.3, NUMB2 = "1.07"
• Retorna: resultado = "0.23"

Exemplo 3:

@DTW_rSUBTRACT("1.3",NUMB2)

• Entrada: NUMB2 = "2.07"
• Retorna: "-0.77"