STRING$

The STRING$ function returns a STRING consisting of a single character repeated a number of times.

Syntax

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

Description

• 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.

Examples

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:

• SAVEIMAGE
• SaveIcon32

See also

• SPACE$
• ASC, CHR$
• ASCII

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link