STRING$ - QB64Official/qb64 GitHub Wiki

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 ERROR Codes error will occur. The count can be zero.
  • If character is a STRING value and its length is zero, an ERROR Codes 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.

Example(s)

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 Example(s)

See Also