STRING$: Difference between revisions

Revision as of 02:48, 23 January 2023

The Template:KW function returns a Template:KW consisting of a single character repeated a number of times.

result$ = STRING$(count&, {character$ | ASCIIcode%} )

count& is the number of times the character specified by character is repeated.
Character is a literal string character, a string variable or an ASCII code number.
If count& is negative, an illegal function call error will occur. The count can be zero.
If character is a STRING value and its length is zero, an 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)

Differences between QB64 and QB 4.5:

QB64 can use LONG values for a count up to 2,147,483,647 while QB 4.5 could only use INTEGER values up to 32,767.

Printing 40 asterisks across the screen using an ASCII character code instead of CHR$(42).

PRINT STRING$(40, 42)

****************************************

Using a STRING to specify the repeated character.

text$ = "B" + STRING$(40, "A") + "D"
PRINT text$

BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD

See examples:

@@ Line 12: / Line 12: @@
 * 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)