Net.Data Reference Guide

Math Functions

These functions let you do most types of mathematical calculations.

• DTW_ADD

• DTW_DIVIDE

• DTW_DIVREM

• DTW_FORMAT

• DTW_INTDIV

• DTW_MULTIPLY

• DTW_POWER

• DTW_SUBTRACT

DTW_ADD

Purpose

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

Adds the values of two parameters.

Syntax

• @DTW_ADD(number1, number2, precision, result)
• @DTW_rADD(number1, number2, precision)

Parameters

Table 12. DTW_ADD Parameters

Data Type	Parameter	Use	Description
float	number1	IN	A variable or literal string representing a number.
float	number2	IN	A variable or literal string representing a number.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains the sum of number1 and number2.

Examples

Example 1:

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

• Input: NUMB1 = "105", NUMB2 = "3"
• Returns: result = "1.1E+2"

Example 2:

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

• Input: NUMB2 = "7.00"
• Returns: "19.00"

DTW_DIVIDE

Purpose

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

Divides the value of the first parameter by the value of the second parameter.

Syntax

• @DTW_DIVIDE(number1, number2, precision, result)
• @DTW_rDIVIDE(number1, number2, precision)

Parameters

Table 13. DTW_DIVIDE Parameters

Data Type	Parameter	Use	Description
float	number1	IN	A variable or literal string representing a number.
float	number2	IN	A variable or literal string representing a number.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains the result of number1 divided by number2.

Examples

Example 1:

@DTW_DIVIDE("8.0", NUMB2, result)

• Input: NUMB2 = "2"
• Returns: result = "4"

Example 2:

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

• Input: "1", NUMB2 = "3"
• Returns: "0.33333"

Example 3:

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

• Input: NUMB1 = "5"
• Returns: "2.5"

DTW_DIVREM

Purpose

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

Divides the first parameter by the second parameter and returns the remainder. The sign of the remainder, if nonzero, is the same as that of the first parameter. If the result cannot be expressed as a whole number, the operation is in error and fails.

Syntax

• @DTW_DIVREM(number1, number2, precision, result)
• @DTW_rDIVREM(number1, number2, precision)

Parameters

Table 14. DTW_DIVREM Parameters

Data Type	Parameter	Use	Description
float	number1	IN	A variable or literal string representing a number.
float	number2	IN	A variable or literal string representing a number.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains the remainder of number1 divided by number2.

Examples

Example 1:

@DTW_DIVREM(NUMB1, NUMB2, result)

• Input: NUMB1 = "2.1", NUMB2 = "3"
• Returns: result = "2.1"

Example 2:

@DTW_rDIVREM("10", NUMB2)

• Input: NUMB2 = "0.3"
• Returns: "0.1"

Example 3:

@DTW_rDIVREM("3.6", "1.3")

• Returns: "1.0"

Example 4:

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

• Returns: "-1"

DTW_FORMAT

Purpose

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

Customizes the formatting for a number. If only the number parameter is specified, the result is formatted just as if @DTW_rADD(number,"0") was performed. If any other options are specified then the number is formatted according to the following rules:

• The before and after options describe how many characters are used for the integer and decimal parts of the result, respectively. If you omit either or both of these, the number of characters used for that part is as many as is needed.

• If before is not large enough to contain the integer part of the number (plus the sign for a negative number), an error results. If before is larger than needed for that part, the number is padded on the left with blanks. If after is not the same size as the decimal part of the number, the number is rounded (or extended with zeros) to fit. Specifying 0 causes the number to be rounded to an integer.

• In addition, expp and expt control the exponent part of the result. The expp sets the number of places for the exponent part; the default is to use as many as is needed (which may be zero). The expt sets the trigger point for use of exponential notation. The default is the default value of the precision parameter.

• If expp is 0, no exponent is supplied and the number is expressed in simple form with added zeros as necessary. If expp is not large enough to contain the exponent, an error results.

• If the number of places needed for the integer or decimal part exceeds expt or twice expt, respectively, exponential notation is used. If expt is 0, exponential notation is always used unless the exponent is 0. (If expp is 0, this overrides a 0 value of expt.) If the exponent is 0 when a nonzero expp is specified, then expp+2 blanks are supplied for the exponent part of the result. If the exponent is 0 and expp is not specified, simple form is used.

Syntax

• @DTW_FORMAT(number, before, after, expp, expt, precision, result)
• @DTW_rFORMAT(number, before, after, expp, expt, precision)

Parameters

Table 15. DTW_FORMAT Parameters

Data Type	Parameter	Use	Description
float	number	IN	A variable or literal string representing a number.
integer	before	IN	A variable or literal string representing a positive whole number. This is an optional parameter. You must enter a null string ("") to have additional parameters.
integer	after	IN	A variable or literal string representing a positive whole number. This is an optional parameter. You must enter a null string ("") to have additional parameters.
integer	expp	IN	A variable or literal string representing a positive whole number. You must enter a null string ("") to have additional parameters.
integer	expt	IN	A variable or literal string representing a positive whole number. You must enter a null string ("") to have additional parameters.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains the number with the specified rounding and formatting.

Examples

Example 1:

@DTW_FORMAT(NUMB, BEFORE, result)

• Input: NUMB = "3", BEFORE = "4"
• Returns: result= " 3"

Example 2:

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

• Returns: result = " 2"

Example 3:

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

• Returns: result = " 1.730"

Example 4:

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

• Returns: result = "-12.7300"

Example 5:

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

• Returns: result = "1.234573E+04"

Example 6:

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

• Returns: result = "1.235"

Example 7:

@DTW_rFORMAT(" - 12.73")

• Returns: " - 12.73"

Example 8:

@DTW_rFORMAT("0.000")

• Returns: "0"

Example 9:

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

• Returns: "12345.73"

Example 10:

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

• Returns: "123456700000.000"

Example 11:

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

• Returns: "1.235E+4"

DTW_INTDIV

Purpose

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

Divides the first parameter by the second parameter and returns the integer part of the result.

Syntax

• @DTW_INTDIV(number1, number2, precision, result)
• @DTW_rINTDIV(number1, number2, precision)

Parameters

Table 16. DTW_INTDIV Parameters

Data Type	Parameter	Use	Description
float	number1	IN	A variable or literal string representing a number.
float	number2	IN	A variable or literal string representing a number.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains integer part of number1 divided by number2.

Examples

Example 1:

@DTW_INTDIV(NUMB1, NUMB2, result)

• Input: NUMB1 = "10", NUMB2 = "3"
• Returns: result = "3"

Example 2:

@DTW_rINTDIV("2", NUMB2)

• Input: NUMB2 = "3"
• Returns: "0"

DTW_MULTIPLY

Purpose

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

Multiplies two parameters.

Syntax

• @DTW_MULTIPLY(number1, number2, precision, result)
• @DTW_rMULTIPLY(number1, number2, precision)

Parameters

Table 17. DTW_MULTIPLY Parameters

Data Type	Parameter	Use	Description
float	number1	IN	A variable or literal string representing a number.
float	number2	IN	A variable or literal string representing a number.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains the product of number1 and number2.

Examples

Example 1:

@DTW_MULTIPLY(NUM1, NUMB2, result)

• Input: NUMB1 = "4", NUMB2 = "5"
• Returns: result = "20"

Example 2:

@DTW_rMULTIPLY("0.9", NUMB2)

• Input: NUMB2 = "0.8"
• Returns: "0.72"

DTW_POWER

Purpose

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

Raises the first parameter to the power of the second parameter.

Syntax

• @DTW_POWER(number1, number2, precision, result)
• @DTW_rPOWER(number1, number2, precision)

Parameters

Table 18. DTW_POWER Parameters

Data Type	Parameter	Use	Description
float	number1	IN	A variable or literal string representing a number.
float	number2	IN	A variable or literal string representing a number.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains the result of number1 raised to the power of number2.

Examples

Example 1:

@DTW_POWER(NUMB1, NUMB2, result)

• Input: NUMB1 = "2", NUMB2 = "-3"
• Returns: result = "0.125"

Example 2:

@DTW_rPOWER("1.7", NUMB2, precision)

• Input: NUMB2 = "8", precision = "5"
• Returns: "69.758"

DTW_SUBTRACT

Purpose

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

Subtracts the value of the second parameter from the value of the first parameter.

Syntax

• @DTW_SUBTRACT(number1, number2, precision, result)
• @DTW_rSUBTRACT(number1, number2, precision)

Parameters

Table 19. DTW_SUBTRACT Parameters

Data Type	Parameter	Use	Description
float	number1	IN	A variable or literal string representing a number.
float	number2	IN	A variable or literal string representing a number.
integer	precision	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	result	OUT	A variable that contains the difference of number1 and number2.

Examples

Example 1: This example shows a way to compare numeric values, which are strings in Net.Data.

@DTW_SUBTRACT(NUM1, NUMB2, comp)
%IF(comp > "0")
<P>$(NUM1) is larger than  $(NUM2).
%ENDIF
 

• Input: NUMB2 = "2.07"
• Returns: "-0.77"

Example 2:

@DTW_SUBTRACT(NUMB1, NUMB2, result)

• Input: NUMB1 = "1.3, NUMB2 = "1.07"
• Returns: result = "0.23"

Example 3:

@DTW_rSUBTRACT("1.3", NUMB2)

• Input: NUMB2 = "2.07"
• Returns: "-0.77"