Forum und email

str_pad

(PHP 4 >= 4.0.1, PHP 5)

str_pad — Rellena una cadena con otra hasta una longitud dada

Descripción

string str_pad ( string $cadena_original , int $longitud_relleno [, string $cadena_relleno [, int $tipo_relleno ]] )

Esta función rellena la cadena cadena_original por la derecha, la izquierda o por ambos lados hasta la longitud indicada. Si no se especifica el argumento opcional cadena_relleno , la cadena_original se rellena con espacios. En caso contrario, será rellenada con los caracteres de cadena_relleno hasta el límite.

El argumento opcional tipo_relleno puede valer STR_PAD_RIGHT, STR_PAD_LEFT o STR_PAD_BOTH. Si no se especifica, se asume que vale STR_PAD_RIGHT.

Si el valor de longitud_relleno es negativo o menor que la longitud de la cadena original, no se produce rellenado alguno.

Example#1 Ejemplo de str_pad()

<?php
$cadena_original 
"Alien";
print 
str_pad($cadena_original10);                      // produce "Alien     "
print str_pad($cadena_original10"-="STR_PAD_LEFT);  // produce "-=-=-Alien"
print str_pad($cadena_original10"_"STR_PAD_BOTH);   // produce "__Alien___"
echo str_pad($cadena_original"___");                // produce "Alien_"
?>

Note: La cadena cadena_relleno puede ser truncada si el número de caracteres de relleno que se necesitan no es multiplo entero de la longitud de cadena_relleno .