Str

Returns a string representation of a number, boolean or Unicode character 
string

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgByteByte ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgUbyteUByte ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgShortShort ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgUshortUShort ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgLongLong ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgUlongULong ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgLongintLongInt ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgUlongintULongInt ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgSingleSingle ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal n KeyPgAsAs KeyPgDoubleDouble ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal b KeyPgAsAs KeyPgBooleanBoolean ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByrefByRef str KeyPgAsAs KeyPgConstQualifierConst KeyPgStringString ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction Str ( KeyPgByvalByVal str KeyPgAsAs KeyPgConstQualifierConst KeyPgWstringWString ) KeyPgAsAs KeyPgStringString

Usage
	result = Str[$]( number )
		or
	result = Str( string )

Parameters
	number
		Numeric expression to convert to a string.
	string
		String expression to convert to a string.

Description
	Str converts numeric variables to their string representation. Used this 
	way it is the KeyPgStringString equivalent to KeyPgWstrWStr applied to numeric variables, 
	and the opposite of the KeyPgValVal function, which converts a string into a 
	number.

	Str converts boolean variables to their string representation "false" / 
	"true".

	Str also converts Unicode character strings to ASCII character strings. 
	Used this way it does the opposite of KeyPgWstrWStr. If an ASCII character string 
	is given, that string is returned unmodified.

Example
	Dim a As Integer
	Dim b As String
	a = 8421
	b = Str(a)
	Print a, b

Dialect Differences
	* In the CompilerOptlang-lang qb dialect, Str will left pad a positive number with a 
	  space.
	* 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).

Platform Differences
	* DOS version/target of FreeBASIC does not support the wide-character 
	  string version of Str.

Differences from QB
	* QB does not support the wide-character string version of Str.

See also
	* KeyPgValVal
	* KeyPgCboolCBool
	* KeyPgChrChr
	* KeyPgAscAsc

