ValLng

Converts a string to a 64bit integer

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction ValLng ( KeyPgByrefByRef strnum KeyPgAsAs KeyPgConstQualifierConst KeyPgStringString ) KeyPgAsAs KeyPgLongintLongInt
	KeyPgDeclareDeclare KeyPgFunctionFunction ValLng ( KeyPgByrefByRef strnum KeyPgAsAs KeyPgConstQualifierConst KeyPgWstringWString ) KeyPgAsAs KeyPgLongintLongInt

Usage
	result = ValLng ( strnum )

Parameters
	strnum
		the string to convert

Return Value
	Returns a KeyPgLongintLongInt of the converted string

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

Description
	For example, ValLng("10") will return 10, and ValLng("10.60") will 
	return 10 as well. 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.  Any non-numeric 
	characters, including decimal points and exponent specifiers, are 
	considered non-suitable, for example, ValLng("23.1E+6") will just return 
	23.

	ValLng can be used to convert integer numbers in KeyPgBinBinary / KeyPgOctOctal / 
	KeyPgHexHexadecimal format, if they have the relevant identifier ("&B" / "&O" / 
	"&H") prefixed, for example: ValLng("&HFF") returns 255.

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

Example
	Dim a As String, b As LongInt
	a = "20xa211"
	b = ValLng(a)
	Print a, b


	20xa211   20

Dialect Differences
	* Not available in the CompilerOptlang-lang qb dialect unless referenced with the 
	  alias __Vallng.

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgClngintCLngInt
	* KeyPgValVal
	* KeyPgValintValInt
	* KeyPgValulngValULng
	* KeyPgStrStr
	* KeyPgChrChr
	* KeyPgAscAsc

