mb_strimwidth 函数

适用 PHP 版本

PHP 5.0.0 及以上版本

函数说明

mb_strimwidth 函数用于截取字符串中的一部分，确保字符串在指定宽度内，同时支持多字节字符（如中文）。如果字符串超过了指定的宽度，函数会进行截取并添加省略号（...）来表示超出部分。此函数适用于需要处理多字节字符集的场景，如中文、日文、韩文等。

函数语法

mb_strimwidth(string $str, int $start, int $width, string $trimmarker = "…", string|null $encoding = null): string

参数

• str (必选): 需要截取的字符串。
• start (必选): 起始位置，表示从字符串的哪个位置开始截取。负值表示从字符串的末尾开始。
• width (必选): 截取后的字符串的最大宽度（以字符为单位）。
• trimmarker (可选): 用于表示被截断部分的符号，默认是"…"。可以自定义其他符号。
• encoding (可选): 字符编码，默认为当前字符集编码。如果不确定编码，通常可以忽略该参数。

返回值

返回截取后的字符串。如果原字符串没有超过宽度，则直接返回原字符串。

示例

假设我们需要从一个中文字符串中截取一定长度的字符，并且希望截取后的字符串能够正确处理多字节字符。

示例代码

下面的代码示例演示了如何使用 mb_strimwidth 函数来截取字符串：

  $str = "这是一段测试字符串，用于演示mb_strimwidth函数。";
  $result = mb_strimwidth($str, 0, 10, '...');
  echo $result; // 输出: 这是一段测试...
  

示例代码说明

在这个示例中，我们定义了一个包含中文字符的字符串，并希望从字符串的起始位置（索引0）开始，截取10个字符宽度的内容。如果字符串超出了宽度限制，函数会自动添加"..."来表示截取部分。