str_pad
(PHP 4 >= 4.0.1, PHP 5)
str_pad — Preenche uma string para um certo tamanho com outra string
Descrição
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.
Example#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_string será truncado se se o número de caracteres de prenchimento não puder ser dividido igualmente pelo tamanho do parâmetro pad_string .