The {{KW|STRING$}} function returns a {{KW|STRING}} consisting of a single character repeated a number of times.


{{PageSyntax}}
: result$ = STRING$(''count%'', {''character$'' | ''ASCIIcode%''} )


{{PageDescription}}
<!-- Stylin -->
* {{Parameter|count%}} is the number of times the character specified by {{Parameter|character}} is repeated.
* Character is a literal string character, a string variable or an [[ASCII]] code number.
* If {{Parameter|count%}} is negative, an [[ERROR Codes|illegal function call]] error will occur. The count can be zero.
* If {{Parameter|character}} is a [[STRING]] value and its length is zero, an [[ERROR Codes|illegal function call]] error will occur.
* If more than one string character value is used, the first character will be repeated. 
* A [[STRING]] statement can be added to a string value with the + [[concatenation]] operator. 
* The function result can also be used to [[GET]] and [[PUT]] a number of bytes as zero characters: bytes$ = STRING(numbytes, 0)


{{PageExamples}}
:Printing 40 asterisks across the screen using an ASCII character value.
{{CodeStart}}{{Cl|PRINT}} {{Cl|STRING$}}(40, 42)
{{CodeEnd}}
{{OutputStart}}****************************************
{{OutputEnd}}


:Using a {{KW|STRING}} to specify the repeated character.
{{CodeStart}}text$ = "B" + {{Cl|STRING$}}(40, "A") + "D"
{{Cl|PRINT}} text$
{{CodeEnd}}
{{OutputStart}}BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD
{{OutputEnd}}
''Note:'' The string contatenation + operator MUST be used in [[STRING]] variable definitions.


''See examples:''
* [[SAVEIMAGE]]
* [[SaveIcon32]]


{{PageSeeAlso}}
* [[SPACE$]]
* [[ASC]], [[CHR$]]
* [[ASCII]]


{{PageNavigation}}