str_pad

(PHP 4 >= 4.0.1)

str_pad -- Rellena una cadena con otra hasta una longitud dada

Descripción

string str_pad ( string entrada, int tama_relleno [, string cad_relleno [, int tipo_relleno]])

Esta función rellena la cadena entrada por la derecha, la izquierda o por ambos lados hasta el largo indicado. Si no se especifica el argumento opcional cad_relleno, entrada es rellenada con espacios. En caso contrario, será rellenada con los caracteres de cad_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 tama_relleno es negativo o menor que la longitud de la cadena de entrada, no se produce rellenado alguno.

Ejemplo 1. Ejemplo de str_pad()

$entrada = "Alien";
print str_pad($entrada, 10);                      // produce "Alien     "
print str_pad($entrada, 10, "-=", STR_PAD_LEFT);  // produce "-=-=-Alien"
print str_pad($entrada, 10, "_", STR_PAD_BOTH);   // produce "__Alien___"