<Ansi string type>.ToNum (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Standard functions

String management functions

Prefix syntax

ToNum

Presentation

Example

Conversion range

Val function and UNICODE

Miscellaneous

See also

<Ansi string type>.ToNum (Function)

In french: <Type Chaîne ansi>.VersNumérique

Returns the numeric value of a character string. This feature enables you to perform numeric calculations on the character strings.

Remark: This function is equivalent to Val.

Example

s is string
s = "143"
s.ToNum() // Returns 143
s = "1.67"
s.ToNum() // Returns 1.67
s = "ABC"
s.ToNum() // Returns 0
s = "3plus2"
s.ToNum() // Returns 3
s = "7,5"
s.ToNum() // Returns 7
s = "1D2"
s.ToNum() // Returns 100
s = "2.5e-2"
s.ToNum() // Returns 0.025

Syntax

<Result> = <Initial string>.ToNum([<Base used>])

<Result>: Real or integer

Numeric value of the string.
0 if an error occurs.
In this version, <Result> corresponds to a real.

<Initial string>: Character string or Buffer

Character string to convert to a numeric value.
For a real, the separator must be the dot ('.') and the prefixes for scientific notation can be 'E', 'e', 'D' or 'd'. If the separator is a comma, the numbers after the comma will be ignored.
New in version 28
This parameter can also be a buffer.

<Base used>: Character string or integer (optional)

Base in which the number is represented. The possible values are as follows:
"d": base 10 (decimal)
"x": base 16 (hexadecimal)
"o": base 8 (octal)
an integer between 2 and 36
Base 10 is used by default.
This parameter is not available. Base 10 is automatically used.

Remarks

Conversion range

<Ansi string type>.ToNum converts a string to an integer if the value is between -9.223.372.036.854.775.808 and 9.223.372.036.854.775.807.

Val function and UNICODE

The <Initial string> can be an ANSI or UNICODE string

For more details on UNICODE, see Managing UNICODE.

Miscellaneous

If a character of <Initial string> cannot be interpreted as a number, <Ansi string type>.ToNum stops interpreting <Initial string> and returns the number corresponding to the characters already read.

Reals can be converted from base 10 only. In other bases, all characters after "." (point) will be ignored.

Component: wd280vm.dll