mb_str_pad
(PHP 8 >= PHP 8.3.0)
mb_str_pad — Pad a multibyte string to a certain length with another multibyte string
说明
string
$string,int
$length,string
$pad_string = " ",int
$pad_type = STR_PAD_RIGHT,?string
$encoding = null): string
This function returns the string
padded on the left, the right, or both sides to the specified
padding length, where the length is measured in Unicode codepoints. If the optional argument
pad_string is not supplied, the
string is padded with spaces, otherwise it
is padded with characters from pad_string
up to the limit.
参数
string-
The input string.
length-
If the value of
lengthis negative, less than, or equal to the length of the input string, no padding takes place, andstringwill be returned. pad_string-
注意:
The
pad_stringmay be truncated if the required number of padding characters can't be evenly divided by thepad_string's length. pad_type-
Optional argument
pad_typecan beSTR_PAD_RIGHT,STR_PAD_LEFT, orSTR_PAD_BOTH. By defaultSTR_PAD_RIGHT. encoding-
encoding参数为字符编码。如果省略或是null，则使用内部字符编码。
返回值
Returns the padded string.
示例
示例 #1 mb_str_pad() example
<?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) "祝祝🎉"
?>