Funções PHP |
. Glossários Funções PHP - str_pad ( ) |
(PHP 4 >= 4.0.1, PHP 5)
str_pad -- Preenche uma string
para um certo tamanho com outra string
string str_pad ( 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:
Uso da função 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.