ValUInt

Converts a string to an unsigned 32bit integer

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction ValUInt ( KeyPgByrefByRef strnum KeyPgAsAs KeyPgConstQualifierConst KeyPgStringString ) KeyPgAsAs KeyPgUlongULong
	KeyPgDeclareDeclare KeyPgFunctionFunction ValUInt ( KeyPgByrefByRef strnum KeyPgAsAs KeyPgConstQualifierConst KeyPgWstringWString ) KeyPgAsAs KeyPgUlongULong

Usage
	result = ValUInt ( strnum )

Parameters
	strnum
		the string to convert

Return Value
	Returns a KeyPgUlongULong value of the converted string

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

Description
	For example, ValUInt("10") will return 10, and ValUInt("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, ValUInt("23.1E+6") will just 
	return 23.

	ValUInt 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: ValUInt("&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 ULong
	a = "20xa211"
	b = ValUInt(a)
	Print a, b


	20xa211   20

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

Differences from QB
	* New to FreeBASIC

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

