Oct

Converts a number to octal representation

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

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

Usage
	result = Oct[$]( 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 octal representation of number.

Description
	Returns the unsigned octal string representation of number. Octal digits 
	range from 0 to 7.

	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 returned string will not be longer than the maximum 
	number of digits required for the type of number (3 characters for KeyPgByteByte, 
	6 for KeyPgShortShort, 11 for KeyPgLongLong, and 22 for KeyPgLongintLongInt)

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

Example
	Print Oct(54321)
	Print Oct(54321, 4)
	Print Oct(54321, 8)

	will produce the output:

	152061
	2061
	00152061

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 11 octal 
	  digits.

See also
	* KeyPgBinBin
	* KeyPgHexHex
	* KeyPgValintValInt
	* KeyPgVallngValLng

