PHP 8.3：新增 mb_str_pad 函数

(PHP 8 >= PHP 8.3.0)

mb_str_pad — 用另一个多字节字符串将多字节字符串填充到一定长度。

说明 

mb_str_pad(
    string $string,
    int $length,
    string $pad_string = " ",
    int $pad_type = STR_PAD_RIGHT,
    ?string $encoding = null
): string

此函数将返回左侧、右侧或两侧填充字符串，将其填充到指定的填充长度，其中长度以 Unicode 代码点为单位测量。如果未提供可选参数pad_string，则会用空格填充字符串，否则会用 pad_string 到极限的字符填充字符串。

参数 

string

输入的字符串

length

如果 length 的值为负数，小于或等于输入字符串的长度，则不会进行填充，并且将返回字符串。

pad_string

注意:

如果所需的填充字符数不能等分 pad_string 的长度，则 pad_string 可能会被截断。

pad_type

可选参数 pad_type 可以是 STR_PAD_RIGHT、STR_PAD_LEFT 或者 STR_PAD_BOTH。默认为 STR_PAD_RIGHT。

encoding

encoding 参数为字符编码。如果省略或是 null，则使用内部字符编码。

返回值 

返回填充后的字符串

示例 

示例 #1 mb_str_pad() 示例

<?php
var_dump(mb_str_pad('▶▶', 6, '❤❓❇', STR_PAD_RIGHT)); // string(18) "▶▶❤❓❇❤"
var_dump(mb_str_pad('▶▶', 6, '❤❓❇', STR_PAD_LEFT)); // string(18) "❤❓❇❤▶▶"
var_dump(mb_str_pad('▶▶', 6, '❤❓❇', STR_PAD_BOTH)); // string(18) "❤❓▶▶❤❓"

var_dump(mb_str_pad("🎉", 3, "祝", STR_PAD_LEFT))); // string(10) "祝祝🎉"
?>