mb_strwidth 函数

适用PHP版本

PHP 5.0.0及以上版本

函数说明

mb_strwidth() 函数用于获取字符串的显示宽度。对于多字节字符（如中文、日文、韩文等），该函数可以正确返回字符所占用的视觉宽度，通常对于全角字符，它们的宽度为2，而半角字符宽度为1。

函数语法

mb_strwidth(string $str, string|null $encoding = null): int

参数

• str (string) – 输入的字符串。
• encoding (string|null) – 可选参数，指定字符编码。默认情况下会使用当前的字符编码。如果没有指定，它会使用 mbstring 配置中设置的默认编码。

返回值

返回字符串的显示宽度（单位为字符数），如果发生错误，则返回 -1。

示例

以下是使用 mb_strwidth() 函数的一个简单示例：

$str = "你好，世界!";
echo mb_strwidth($str);  // 输出 10，因为“你”是2个宽度，“好”是2个宽度，其他字符是1个宽度。
  

示例代码的说明

在这个例子中，字符串 "你好，世界!" 包含了中文字符和符号。中文字符（如“你”和“好”）通常占用两个字符的宽度，而其他符号（如逗号、空格、感叹号）占用一个字符宽度。使用 mb_strwidth() 函数时，它会将所有字符的宽度累加，返回字符串的总宽度。