Função str_pad

A função str_pad preenche uma string com outra string até um comprimento especificado. O primeiro parâmetro recebe a string, o segundo - o número de caracteres, até o qual a string deve ser preenchida, o terceiro parâmetro - é com o que a string deve ser preenchida.

O quarto parâmetro opcional especifica de qual lado preencher a string. Este parâmetro pode assumir os seguintes valores: STR_PAD_LEFT - preencher a string à esquerda, STR_PAD_RIGHT - preencher a string à direita (este é o valor padrão).

Sintaxe

str_pad(string $string, int $length, string $pad_string = " ", int $pad_type = STR_PAD_RIGHT): string

Exemplo

Vamos preencher a string com o caractere '+' para que a string tenha 10 caracteres:

<?php
	$arr = 'abcde';
	echo str_pad($arr, 10, '+');
?>

Resultado da execução do código:

'abcde+++++'

Exemplo

Agora a string será preenchida não à direita, mas à esquerda:

<?php
	$arr = 'abcde';
	echo str_pad($arr, 10, '+', STR_PAD_LEFT);
?>

Resultado da execução do código:

'+++++abcde'

Veja também

a função array_pad,
que preenche um array com elementos especificados
a função array_fill,
que preenche um array com um valor necessário
a função str_repeat,
que repete uma string um número especificado de vezes