Converts a value to a number.

Note This @function is new with Release 6.

Syntax

@ToNumber(value)

Parameters

value

Text, number, or list thereof. A value that cannot be converted returns the error, "The value cannot be converted to a Number."

number

Number or number list. The value converted to a number.

If the parameter is a list, the function operates on each element of the list, and the return value is a list with the same number of elements. A failure occurs if any element cannot be converted.

This function is useful for ensuring that a value has a number data type before using it in functions that require numbers as parameters.

Language cross-reference

Val function of LotusScript language

Str function of LotusScript language

CInt function of LotusScript language

CLng function of LotusScript language

CSng function of LotusScript language

CDbl function of LotusScript language

Example
See Also

Converting data types
@TextToNumber

Glossary