Sign in Join
FPDoc Onlineexperiment

DupeString function

In unit StrUtils

Creates and concatenates N copies of a string.

Declaration

pascal
function DupeString(const AText: string; ACount: Integer): string

Arguments

AText

String to duplicate.

ACount

Number of copies to create.

Function result

Copies of the original string.

Description

DupeString returns a string consisting of ACount concatenations of AText. Thus

DupeString('1234567890',3);

will produce a string

'123456789012345678901234567890'

If aCount<=0 then the result is an empty string.

Errors

If you specify a too large aCount (so the resulting string would require more memory than allowed on your system) then an EOutOfMemory exception can be raised.

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.