CULngInt

Converts numeric or string expression to 64-bit unsigned integer (KeyPgUlongintULongInt)

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction CULngInt ( KeyPgByvalByVal expression KeyPgAsAs DataTypedatatype ) KeyPgAsAs KeyPgUlongintULongInt

	KeyPgTypeType typename
		KeyPgDeclareDeclare KeyPgOperatorOperator KeyPgCastCast ( ) KeyPgAsAs KeyPgUlongintULongInt
	End Type

Usage
	result = CULngInt( numeric expression )
	result = CULngInt( string expression )
	result = CULngInt( user defined type )

Parameters
	expression
		a numeric, string, or pointer expression to cast to a KeyPgUlongintULongInt value
	datatype
		any numeric, string, or pointer data type
	typename
		a user defined type

Return Value
	A KeyPgUlongintULongInt value.

Description
	The CULngInt function rounds off the decimal part and returns a 64-bit 
	KeyPgUlongintULongInt value.  The function does not check for an overflow, and 
	results are undefined for values which are less than 0 or larger than 18 
	446 744 073 709 551 615.  Additionally, casts from floating-point 
	expressions are currently not guaranteed to work for values higher than 
	2^63 (9 223 372 036 854 775 808).

	The name can be explained as 'Convert to Unsigned LoNG INTeger'.

	If the argument is a string expression, it is converted to numeric by 
	using KeyPgValulngValULng.

Example
	' Using the CLNGINT function to convert a numeric value

	'Create an UNSIGNED LONG INTEGER variable
	Dim numeric_value As ULongInt

	'Convert a numeric value
	numeric_value = CULngInt(12345678.123)

	'Print the result, should return 12345678
	Print numeric_value
	Sleep

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

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgCbyteCByte
	* KeyPgCubyteCUByte
	* KeyPgCshortCShort
	* KeyPgCushortCUShort
	* KeyPgCintCInt
	* KeyPgCuintCUInt
	* KeyPgClngCLng
	* KeyPgCulngCULng
	* KeyPgClngintCLngInt
	* KeyPgCsngCSng
	* KeyPgCdblCDbl

