Дополнение строки до заданной длины в PHP

Стандартная функция str_pad()

Синтаксис

string str_pad ( string $string , int $padLength [ , string $padString = ' ' [ , int $padType = STR_PAD_RIGHT ] ] )

Аргументы

1. $string — дополняемая строка;
2. $padLength — нужная длина строки;
3. $padString — строка дополнения;
4. $padType — тип дополнения:
   • STR_PAD_BOTH — с обоих краев,
   • STR_PAD_LEFT — с левого края,
   • STR_PAD_RIGHT — с правого края.

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

Возвращает строку string, дополненную до длины padLength.

Особенности

• НЕБЕЗОПАСНА для многобайтных строк. Если в 1-й или 2-й аргумент функции передать многобайтную строку, то результат работы функции будет неправильным (кроме отдельных случаев). Поэтому при работе с многобайтными строками нужно использовать альтернативную реализацию.
• При дополнении строки с обоих краев (STR_PAD_BOTH) важно помнить, что при вычислении левого и правого дополнений строки в приоритете правый край. Т.е. если строка увеличивается на 3 символа, то к правому краю добавиться 2 символа, а к левому — 1.