(PHP 4 >= 4.0.1, PHP 5, PHP 7)
str_pad — Preenche uma string para um certo tamanho com outra string
$input
, int $pad_length
[, string $pad_string
[, int $pad_type
]] )
Esta função retorna a string input
preenchida na esquerda, direita ou ambos os lados até o
tamanho especificado. Se o parâmetro opcional
pad_string não for indicado,
input é preenchido com espaços, se não
é preenchido com os caracteres de pad_string
até o limite.
O parâmetro opcional pad_type pode ser
STR_PAD_RIGHT (preencher a direita), STR_PAD_LEFT (preencher a esquerda), ou STR_PAD_BOTH (preencher de
ambos os lados). If pad_type não for especificado é
assumido que seja STR_PAD_RIGHT.
Se o valor de pad_length é negativo ou menor
do que o tamanho da string , não há nenhum preenchimento.
Exemplo #1 Exemplo str_pad()
<?php
$input = "Alien";
print str_pad($input, 10); // produz "Alien "
print str_pad($input, 10, "-=", STR_PAD_LEFT); // produz "-=-=-Alien"
print str_pad($input, 10, "_", STR_PAD_BOTH); // produz "__Alien___"
print str_pad($input, 6 , "___"); // produces "Alien_"
?>
Nota:
O parâmetro
pad_stringserá truncado se se o número de caracteres de prenchimento não puder ser dividido igualmente pelo tamanho do parâmetropad_string.