Manual do PHP
Anterior |  | Próxima

# str_pad

(PHP 4 >= 4.0.1, PHP 5)

str_pad -- Preenche uma string para um certo tamanho com outra string

## Descrição

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 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.

Anterior | Principal | Próxima
str_ireplace | Acima | str_repeat