mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-31 11:10:18 +00:00
47 lines
1.7 KiB
Text
47 lines
1.7 KiB
Text
|
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}}
|