$DIV (division)
$DIV performs division, treating character strings as numeric values, and returns the arithmetic result.
For example, the Asset Console standard memory and disk sizes are managed in megabyte units. To register information managed in gigabyte units in the asset management database, you need to change the units to megabytes. To do so, you can use the $DIV embedded function to convert from gigabytes to megabytes.
Syntax
return-value=$DIV(character-string,numeric-character)
Values
-
return-value
Specifies the name of the variable into which the arithmetic result is set. Valid results range from 0.0001 to 999,999,999,999,999 (15 digits).
-
character-string
Specifies a dividend, either as a constant or a variable. A constant must be enclosed in single quotation marks (''). Specified values can range from 0.0001 to 999,999,999,999,999 (15 digits).
-
numeric-character
Specifies a divisor, either as a constant or a variable. A numeric value specified as a constant that includes a decimal point must be enclosed in single quotation marks (''). Specified values can range from 0.0001 to 999,999,999,999,999 (15 digits).
Status
The following table lists and describes the possible statuses:
Status |
Description |
---|---|
NORMAL |
Normal end |
NODATA |
Indicates one of the following:
|
ERROR |
— |
Script execution interrupted |
An invalid argument was specified, or an error other than the above occurred. |
Remarks
If a value that cannot be specified in character-string or numeric-character is encountered, or if the arithmetic result is a value outside the representable range, 0 is returned to return-value.
Example
The following example calculates 10 ÷ 5 and outputs the results:
[SET_VALUE] VAL1 = 10 VAL2 = $DIV(VAL1, 5) MSG = 'DIV: ' +VAL1+ ' / 5 = ' +VAL2 $ECHO(MSG)
- Execution result:
-
DIV: 10 / 5 = 2