mb_str_pad
Дополняет строку до нужной длины, считая символы, а не байты.
Синтаксис
mb_str_pad(string $string, int $length, string $pad_string = " ", int $pad_type = STR_PAD_RIGHT, ?string $encoding = null): stringПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $string | string | Исходная строка. |
| $length | int | Нужная длина в символах. |
| $pad_string | string | Необязательный. Чем дополнять. |
| $pad_type | int | Необязательный. Сторона: `STR_PAD_RIGHT`, `STR_PAD_LEFT`, `STR_PAD_BOTH`. |
| $encoding | ?string | Необязательный. Кодировка. |
Возвращаемое значение
stringДополненная строка.
Примеры
Выравнивание кириллицы:
<?php
echo '[', str_pad('Чай', 6, '.'), "]\n";
echo '[', mb_str_pad('Чай', 6, '.'), ']';Результат:
[Чай]
[Чай...]Примечания
Функция появилась в PHP 8.3. str_pad() считает байты, поэтому строки с кириллицей выравнивает неверно.
См. также
- str_pad — Дополняет строку до заданной длины.
- mb_strlen — Возвращает количество символов в строке.
- mb_strimwidth — Обрезает строку до заданной ширины и добавляет в конец метку.
В учебнике
- Строки — Работа со строками в PHP — кавычки, склейка, длина, поиск, замена и функции для кириллицы.