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()函式將使用內部字元編碼。
• 如果輸入字串的長度已經大於或等於指定的填充長度，則不會進行填充操作。
• 如果輸入字串的長度與指定的填充長度之差為奇數，則在填充的過程中，右側（或左側）的填充字元會比左側（或右側）的填充字元多一個。