ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / String functions
  • Conversion range
  • Val function and UNICODE
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
StringToNum (Function)
In french: ChaîneVersNumérique
Returns the numeric value of a character string. This feature enables you to perform numeric calculations on strings.
Remark: This function is equivalent to Val.
Example
StringToNum("143")    // Returns 143
StringToNum("1.67")    // Returns 1.67
StringToNum("ABC")    // Returns 0
StringToNum ("3plus2") // Returns 3
StringToNum("7,5")    // Returns 7
StringToNum("1D2")    // Returns 100
StringToNum("2.5e-2") // Returns 0.025
Syntax
<Result> = StringToNum(<Initial string>)
<Result>: Real or integer
  • Numeric value of the string.
  • "inf" (for " Infinite "), if the result exceeds the capabilities of a real. We advise you to use the conversion to an Variable of type Integer.
  • 0 if an error occurs.
<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.
This parameter can also be a buffer. In this case, the buffer will be processed differently, according to the option selected in the "Unicode" tab of the configuration description:
  • if "Use ANSI strings at runtime" is selected, the buffer will be processed as an ANSI string.
  • if "Use UNICODE strings at runtime" is selected, the buffer will be processed as an ANSI or UNICODE string, depending on its content.
Remarks

Conversion range

StringToNum 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, StringToNum 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: wd290vm.dll
Minimum version required
  • Version 27
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/09/2023

Send a report | Local help