Bin

Returns a binary (base 2) string representation of an integer

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

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

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

Parameters
	number
		A number or expression evaluating to a number.  A floating-point 
		number will be converted to a KeyPgLongintLongInt.
	digits
		Desired number of digits in the returned string.

Return Value
	A string containing the unsigned binary representation of number.

Description
	Returns a string representing the unsigned binary value of the integer 
	number. Binary digits range from 0 to 1.

	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 (32 for a KeyPgLongLong, 64 for a KeyPgLongintLongInt)
	.

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

Example
	Print Bin(54321)
	Print Bin(54321, 5)
	Print Bin(54321, 20)

	will produce the output:

	1101010000110001
	10001
	00001101010000110001

Dialect Differences
	* Not available in the CompilerOptlang-lang qb dialect unless referenced with the 
	  alias __Bin.
	* The string type suffix "$" is ignored in the CompilerOptlang-lang fblite dialect, 
	  always warn.
	* The string type suffix "$" is ignored in the CompilerOptlang-lang fb dialect, always 
	  warn.

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgOctOct
	* KeyPgHexHex
	* KeyPgValintValInt
	* KeyPgVallngValLng

