Description
Builds a string of the specified length by repeating the specified characters until the result string is long enough.
Syntax
Fill ( chars, n )
Argument |
Description |
---|---|
chars |
A string whose value will be repeated to fill the return string |
n |
A long whose value is the number of characters in the string you want returned |
Return value
String. Returns a string n characters long filled with repetitions of the characters in the argument chars. If the argument chars has more than n characters, the first n characters of chars are used to fill the return string. If the argument chars has fewer than n characters, the characters in chars are repeated until the return string has n characters.
Usage
Fill is used to create a line or other special effect. For example, asterisks repeated in a printed report can fill an amount line, or hyphens can simulate a total line in a screen display.
Examples
This expression returns a string containing 35 asterisks:
Fill("*", 35)
This expression returns the string -+-+-+-:
Fill("-+", 7)
This expression returns 10 tildes (~):
Fill("~~", 10)
See also
Fill in the section called “Fill” in PowerScript Reference