mb_str_pad

(PHP 8 >= PHP 8.3.0)

mb_str_pad — 用另一个多字节字符串将多字节字符串填充到特定长度

描述

mb_str_pad(
    string $string,
    int $length,
    string $pad_string = " ",
    int $pad_type = STR_PAD_RIGHT,
    ?string $encoding = null
): string

此函数返回在左侧、右侧或两侧填充到指定填充长度的 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) "祝祝🎉"
?>

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加说明

用户贡献的说明

此页面没有用户贡献的说明。