PHP 大会日本 2024

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 的字符填充,直到达到限制。

参数

字符串

输入字符串。

长度

如果 length 的值小于、等于或小于输入字符串的长度,则不进行填充,并且将返回 string

pad_string

注意:

如果所需的填充字符数量不能被 pad_string 的长度整除,则 pad_string 可能会被截断。

pad_type

可选参数 pad_type 可以是 STR_PAD_RIGHTSTR_PAD_LEFTSTR_PAD_BOTH。默认情况下为 STR_PAD_RIGHT

编码

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) "祝祝🎉"
?>

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top