str_repeat

(PHP 4, PHP 5, PHP 7, PHP 8)

str_repeat — Repeat a string

Description

function str_repeat(string $string, int $times): string

Returns string repeated times times.

Parameters

string

The string to be repeated.

times

Number of times the string string should be repeated.

times has to be greater than or equal to 0. If the times is set to 0, the function will return an empty string.

Return Values

Returns the repeated string.

Errors/Exceptions

Throws a ValueError if times is less than 0.

Changelog

Version Description
8.0.0 Now throws a ValueError if times is less than 0. Previously, an E_WARNING was raised and null was returned.

Examples

Example #1 str_repeat() example

<?php
echo str_repeat("-=", 10);
?>

The above example will output:

-=-=-=-=-=-=-=-=-=-=

See Also