Fill

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

Returns

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

Example 1

This expression returns a string containing 35 asterisks:

Fill("*", 35)

Example 2

This expression returns the string -+-+-+-:

Fill("-+", 7)

Example 3

This expression returns 10 tildes (~):

Fill("~", 10)

See also