mb_str_pad

(PHP 8 >= PHP 8.3.0)

mb_str_pad — 將多位元組字串以另一個多位元組字串填充到特定長度

說明

mb_str_pad(
    字串 $string,
    整數 $length,
    字串 $pad_string = " ",
    整數 $pad_type = STR_PAD_RIGHT,
    ?字串 $encoding = null
): 字串

這個函式會將 string 以指定的填充長度在其左邊、右邊或兩邊進行填充，其中長度以 Unicode 字碼點計算。如果未提供可選參數 pad_string，則 string 會以空格填充；否則，它會以 pad_string 中的字元填充到指定的長度上限。

參數

string: 輸入字串。
length: 如果 length 的值為負數、小於或等於輸入字串的長度，則不會進行填充，並且會返回 string。
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) "祝祝🎉"
?>

發現問題了嗎？

瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤

＋新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。