Función str_pad() de PHP

Ejemplo

Rellenar el lado derecho de la cadena hasta una nueva longitud de 30 caracteres:

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

Ejemplo en ejecución

Definición y uso

La función str_pad() de PHP rellena una cadena a una nueva longitud.

Sintaxis

str_pad(string,length,pad_string,pad_type)
Parámetros Descripción
string Obligatorio. Define la cadena a rellenar.
length Obligatorio. Define la nueva longitud de la cadena. Si este valor es menor que la longitud original de la cadena, no se realiza ninguna acción.
pad_string Opcional. Define la cadena de relleno. Por defecto son los espacios en blanco.
pad_type

Opcional. Define qué lado de la cadena rellenar.

Valores posibles:

  • STR_PAD_BOTH - Rellenar los lados de la cadena. Si no es par, el lado derecho recibe el relleno adicional.
  • STR_PAD_LEFT - Rellenar el lado izquierdo de la cadena.
  • STR_PAD_RIGHT - Rellenar el lado derecho de la cadena. Por defecto.

Detalles técnicos

Valor devuelto: Devuelve la cadena rellenada.
Versión de PHP: 4.0.1+

Más ejemplos

Ejemplo 1

Rellenar el lado izquierdo de la cadena:

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

Ejemplo en ejecución

Ejemplo 2

Rellenar los lados de la cadena:

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

Ejemplo en ejecución