Дополняет строку другой строкой до заданной длины


(PHP 4 >= 4.0.1, PHP 5)

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

Описание

string str_pad ( string $input , int $pad_length [, string $pad_string = " " [, int $pad_type = STR_PAD_RIGHT ]] )

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

Список параметров

input

Входная строка.

pad_length

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

pad_string

Замечание:

pad_string может быть урезана, если необходимое количество дополняемых символов не делится нацело на длину строки pad_string.

pad_type

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

Возвращаемые значения

Возвращает дополненную строку.

Примеры

Пример #1 Пример использования str_pad()

<?php
$input 
"Alien";
echo 
str_pad($input10);                      // выводит "Alien     "
echo str_pad($input10"-="STR_PAD_LEFT);  // выводит "-=-=-Alien"
echo str_pad($input10"_"STR_PAD_BOTH);   // выводит "__Alien___"
echo str_pad($input"___");               // выводит "Alien_"
?>