[函数]mb_str_pad()函数—用法及示例

函数名称：mb_str_pad()

适用版本：PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8

函数说明：mb_str_pad()函数在字符串的两侧使用指定的字符串填充字符串，以使字符串达到指定的长度。此函数是mbstring扩展提供的，用于处理多字节字符。

用法：string mb_str_pad ( string $input , int $pad_length [, string $pad_string = " " [, int $pad_type = STR_PAD_RIGHT [, string $encoding = mb_internal_encoding() ]]] )

参数：

• $input：输入的字符串。
• $pad_length：填充后的字符串长度，如果该值小于原字符串长度，则不会进行填充。
• $pad_string（可选）：用于填充的字符串，默认为一个空格。
• $pad_type（可选）：填充类型，可选值为STR_PAD_RIGHT（默认，右侧填充）、STR_PAD_LEFT（左侧填充）、STR_PAD_BOTH（两侧填充）。
• $encoding（可选）：字符编码，默认为mb_internal_encoding()。

返回值：返回填充后的字符串。

示例：

$input = "Hello";
$pad_length = 10;
$pad_string = "-";
$pad_type = STR_PAD_RIGHT;
$encoding = "UTF-8";

$result = mb_str_pad($input, $pad_length, $pad_string, $pad_type, $encoding);
echo $result; // 输出：Hello-----

$result = mb_str_pad($input, $pad_length, $pad_string, STR_PAD_LEFT, $encoding);
echo $result; // 输出：-----Hello

$result = mb_str_pad($input, $pad_length, $pad_string, STR_PAD_BOTH, $encoding);
echo $result; // 输出：-Hello---

注意事项：

• 如果指定的编码无效或不支持，mb_str_pad()函数将使用内部字符编码。
• 如果输入字符串的长度已经大于或等于指定的填充长度，则不会进行填充操作。
• 如果输入字符串的长度与指定的填充长度之差为奇数，则在填充的过程中，右侧（或左侧）的填充字符会比左侧（或右侧）的填充字符多一个。