str_pad

str_pad

(PHP 4 >= 4.0.1)

str_pad - заполняет строку определённой длины другой строкой.

Описание

string str_pad (string input, int pad_length [, string pad_string [, int pad_type]])

Эта функция возвращает строку input, заполненную влево, вправо или в обоих направлениях на специфицированную длину. Если необязательный аргумент pad_string отсутствует, input заполняется пробелами, иначе заполняется символами из pad_string до верхней границы.

Необязательный аргумент pad_type может быть: STR_PAD_RIGHT, STR_PAD_LEFT или STR_PAD_BOTH. Если pad_type не специфицирован, принимается STR_PAD_RIGHT.

Если значение pad_length отрицательное или меньше длины input-строки, заполнение не выполняется.

$input = "Alien";
print str_pad($input, 10);                      // даёт "Alien     "
print str_pad($input, 10, "-=", STR_PAD_LEFT);  // даёт "-=-=-Alien"
print str_pad($input, 10, "_", STR_PAD_BOTH);   // даёт "__Alien___"