Hex

Returns the hexadecimal of the given number

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUbyteUByte ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUshortUShort ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUlongULong ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUlongintULongInt ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgConstConst KeyPgAnyAny KeyPgPtrPtr ) KeyPgAsAs KeyPgStringString

	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUbyteUByte, KeyPgByvalByVal digits KeyPgAsAs KeyPgLongLong ) KeyPgAsAs 
	KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUshortUShort, KeyPgByvalByVal digits KeyPgAsAs KeyPgLongLong ) KeyPgAsAs 
	KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUlongULong, KeyPgByvalByVal digits KeyPgAsAs KeyPgLongLong ) KeyPgAsAs 
	KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgUlongintULongInt, KeyPgByvalByVal digits KeyPgAsAs KeyPgLongLong ) 
	KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Hex ( KeyPgByvalByVal number KeyPgAsAs KeyPgConstConst KeyPgAnyAny KeyPgPtrPtr, KeyPgByvalByVal digits KeyPgAsAs 
	KeyPgLongLong ) KeyPgAsAs KeyPgStringString

Usage
	result = Hex[$]( number [, digits ] )

Parameters
	number
		A number or expression evaluating to a number.  A floating-point 
		number will be converted to a KeyPgLongintLongInt.
	digits
		Optional number of digits to return.

Return Value
	A KeyPgStringString containing the unsigned hexadecimal representation of number.

Description
	Returns the unsigned hexadecimal string representation of the integer 
	number. Hexadecimal digits range from 0-9, or A-F.

	If you specify digits > 0, the result string will be exactly that 
	length.  It will be truncated or padded with zeros on the left, if 
	necessary.

	The length of the string will not go longer than the maximum number of 
	digits required for the type of number (8 for a KeyPgLongLong, 16 for a KeyPgLongintLongInt).

	If you want to do the opposite, i.e. convert a hexadecimal string back 
	into a number, the easiest way to do it is to prepend the string with 
	"&H", and convert it to an integer type, using a function like KeyPgCintCInt, 
	similarly to a normal numeric string.  E.g. KeyPgCintCInt("&HFF")

Example
	'54321 is D431 in hex
	Print Hex(54321)
	Print Hex(54321, 2)
	Print Hex(54321, 5)

	will produce the output:

	D431
	31
	0D431

Dialect Differences
	* The string type suffix "$" is required in the CompilerOptlang-lang qb dialect.
	* The string type suffix "$" is optional in the CompilerOptlang-lang fblite dialect.
	* The string type suffix "$" is ignored in the CompilerOptlang-lang fb dialect, warn 
	  only with the CompilerOptw-w suffix compile option (or CompilerOptw-w pedantic compile 
	  option).

Differences from QB
	* In QBASIC, there was no way to specify the number of digits returned.
	* The size of the string returned was limited to 32 bits, or 8 
	  hexadecimal digits.

See also
	* KeyPgBinBin
	* KeyPgOctOct
	* KeyPgValintValInt
	* KeyPgVallngValLng

