Função str_pad() PHP

Funções String PHP

Exemplo

Preencher o lado direito da string para um novo comprimento de 30 caracteres:

<?php
$str = "Hello World";
echo str_pad($str,30,".");
?>

Executar exemplo

Definição e uso

A função str_pad() do PHP preenche a string para um novo comprimento.

Sintaxe

str_pad(string,length,pad_string,pad_type)
Parâmetros Descrição
string Obrigatório. Especifica a string a ser preenchida.
length Obrigatório. Especifica o nova comprimento da string. Se este valor for menor que o comprimento original da string, não há nenhuma operação.
pad_string Opcional. Especifica a string para usar como preenchimento. O padrão é o espaço em branco.
pad_type

Opcional. Especifica o lado da string para preencher.

Valores possíveis:

  • STR_PAD_BOTH - Preencher os lados da string. Se não for par, o lado direito recebe o preenchimento adicional.
  • STR_PAD_LEFT - Preencher o lado esquerdo da string.
  • STR_PAD_RIGHT - Preencher o lado direito da string. O padrão.

Detalhes técnicos

Retorno: Retorna a string preenchida.
Versão PHP: 4.0.1+

Mais exemplos

Exemplo 1

Preencher o lado esquerdo da string:

<?php
$str = "Hello World";
echo str_pad($str,30,".",STR_PAD_LEFT);
?>

Executar exemplo

Exemplo 2

Preencher os lados da string:

<?php
$str = "Hello World";
echo str_pad($str,30,".:",STR_PAD_BOTH);
?>

Executar exemplo

Funções String PHP