php-str_pad

  • 08.07.2026
  • admin
  • 1минут читать

<str_pad>

(PHP 4 >= 4.0.1, PHP 5)

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

Описание

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

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

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

Если pad_length меньше длины строки input , строка возвращается без изменений.


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

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

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