Built-in Functions › STRING-REPEAT

STRING-REPEAT

Purpose

Returns the string that results from repeating a string value a specified number of times.

Syntax

►►─┬─ STRING-REPEAT ─┬─ ( string, repetitions ) ──────────────────────────────►◄
   └─ SREPeat ───────┘

Parameters

string

Specifies the string value that is repeated.

String can be:

• A string literal, enclosed in single quotation marks
• The name of a user-defined variable data field containing the string

repetitions

Specifies the numeric value representing the number of times that the string value is to be repeated.

Repetitions can be:

• An arithmetic expression
• The name of a user-defined variable data field
• A user-supplied numeric literal

Example

In the following example, the repeat function is used to repeat the constant 'NAME' two times:

Statement:
    MOVE SREPEAT('NAME',2) TO WK-TARGET.
Returned string:
    'NAMENAMENAME'