String (Function)

Creates and fills a string of a certain length with a certain character

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction String ( KeyPgByvalByVal count KeyPgAsAs KeyPgIntegerInteger, KeyPgByvalByVal ch_code KeyPgAsAs KeyPgLongLong 
	) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction String ( KeyPgByvalByVal count KeyPgAsAs KeyPgIntegerInteger, KeyPgByrefByRef ch KeyPgAsAs KeyPgConstQualifierConst 
	KeyPgStringString ) KeyPgAsAs KeyPgStringString

Usage
	result = String[$]( count, ch_code )
		or
	result = String[$]( count, ch )

Parameters
	count
		An integer specifying the length of the string to be created.
	ch_code
		A long specifying the CptAsciiASCII character code to be used to fill the 
		string.
	ch
		A string whose first character is to be used to fill the string.

Return Value
	The created string. An empty string will be returned if either ch is an 
	empty string, or count <= 0.

Description
	The String function returns a string with a length of count, filled with 
	a given ch_code or ch.

Example
	Print String( 4, 69 )         '' prints "EEEE"
	Print String( 5, "Indeed" )   '' prints "IIIII"
	End 0

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
	* None 

See also
	* KeyPgStringString (data type)
	* KeyPgSpaceSpace

   
