Val

Converts a string to a floating point number

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction Val ( KeyPgByrefByRef str KeyPgAsAs KeyPgConstQualifierConst KeyPgStringString ) KeyPgAsAs KeyPgDoubleDouble
	KeyPgDeclareDeclare KeyPgFunctionFunction Val ( KeyPgByrefByRef str KeyPgAsAs KeyPgConstQualifierConst KeyPgWstringWString ) KeyPgAsAs KeyPgDoubleDouble

Usage
	result = Val( strnum )

Parameters
	strnum
		the string containing a number to convert

Return Value
	Returns a converted KeyPgDoubleDouble precision number

	If the first character of the string is invalid, Val will return 0.

Description
	Val("10") will return 10.0, and Val("10.10") will return 10.1. The 
	function parses the string from the left, skipping any white space, and 
	returns the longest number it can read, stopping at the first 
	non-suitable character it finds.  Scientific notation is recognized, 
	with "D" or "E" used to specify the exponent.

	Val can be used to convert integer numbers in binary / octal / 
	hexadecimal format, if they have the relevant identifier ("&B" / "&O" / 
	"&H") prefixed, for example: Val("&HFF") returns 255.

	Note:
	If you want to get an integer value from a string, consider using KeyPgValintValInt 
	or KeyPgVallngValLng instead.  They are faster, since they don't use floating-point 
	numbers, and only KeyPgVallngValLng provides full 64-bit precision for KeyPgLongintLongInt 
	types.

	If you want to convert a number into string format, use the KeyPgStrStr 
	function.

Example
	Dim a As String, b As Double
	a = "2.1E+30xa211"
	b = Val(a)
	Print a, b


	2.1E+30xa211   2.1e+030

Differences from QB
	* None

See also
	* KeyPgCdblCDbl
	* KeyPgValintValInt
	* KeyPgValuintValUInt
	* KeyPgVallngValLng
	* KeyPgValulngValULng
	* KeyPgStrStr
	* KeyPgChrChr
	* KeyPgAscAsc

