简体中文
简体中文
：使用 mb_strcut 截取字符串后，出现乱码，或者截取出的字符串末尾字符不完整。
原因：mb_strcut 是按字节截取字符串，不是按字符截取。如果截取的位置正好落在一个多字节字符的中间，结果会导致字符断裂，从而显示乱码。
<?php
$str = "你好，世界";
echo mb_strcut($str, 0, 5, "UTF-8");
// 输出可能是乱码，因为“你”是3字节，“好”是3字节，截取5字节会截断“好”字
?>
错误现象：截取结果不正确，或者输出异常。
原因：如果没有显式指定正确的编码，mb_strcut 会使用内部默认编码（通常是 mb_internal_encoding() 的值），而这可能与字符串实际编码不符，导致截取错误。
<?php
$str = "こんにちは";
echo mb_strcut($str, 0, 4); // 未指定编码，默认可能不是 UTF-8，结果异常
?>
错误现象：函数报错或行为异常。
原因：mb_strcut 的前两个参数（字符串、起始位置）和第三个参数（截取长度）必须是整数或可转换为整数的值，且起始位置和长度不能为负数（长度可以省略）。传入非整数或负值会导致错误。
<?php
$str = "Hello World";
echo mb_strcut($str, "a", 5); // 起始位置应为整数，传入字符串会出错
?>
由于 mb_strcut 按字节截取，所以要确保截取长度不会导致多字节字符被截断。常用方法是先计算多字节字符长度，然后根据需要截取对应字节长度，或者改用 mb_substr 按字符截取。
<?php
$str = "你好，世界";
// 使用 mb_substr 按字符截取，避免截断字符
echo mb_substr($str, 0, 2, "UTF-8"); // 输出：你好
?>
如果必须使用 mb_strcut，则要确保截取的字节数是完整字符的边界：
<?php
$str = "你好，世界";
$length = 6; // 3字节 * 2个字符
echo mb_strcut($str, 0, $length, "UTF-8"); // 输出：你好
?>
为了避免因默认编码不匹配导致的问题，调用 mb_strcut 时应始终指定字符编码参数，通常是 "UTF-8"。
<?php
$str = "こんにちは";
echo mb_strcut($str, 0, 6, "UTF-8");
?>
在使用 mb_strcut 之前，确保传入的起始位置和长度参数为非负整数，可以通过 intval() 或 filter_var() 等函数进行类型转换和校验，避免错误。
<?php
$start = intval($_GET['start'] ?? 0);
$length = intval($_GET['length'] ?? 10);
$str = "Hello, 世界";
echo mb_strcut($str, $start, $length, "UTF-8");
?>
<?php
function safe_mb_strcut(string $string, int $start, int $length = null, string $encoding = 'UTF-8'): string {
// 确保起始位置和长度为非负整数
$start = max(0, $start);
if ($length !== null) {
$length = max(0, $length);
}
// 获取字符串字节长度
$byteLength = strlen(mb_convert_encoding($string, 'UTF-8'));
if ($start > $byteLength) {
return '';
}
if ($length === null) {
$length = $byteLength - $start;
} else if ($start + $length > $byteLength) {
$length = $byteLength - $start;
}
return mb_strcut($string, $start, $length, $encoding);
}
// 使用示例
$str = "你好，GitBox用户！";
echo safe_mb_strcut($str, 0, 9, "UTF-8"); // 截取前3个汉字
?>
通过上述分析与示例，正确使用 mb_strcut 的关键在于：
明确指定字符编码；
确保参数类型正确且有效；
注意截取字节数不要截断多字节字符，或使用 mb_substr 替代按字符截取。
掌握这些技巧后，mb_strcut 在多字节字符串处理时将更为可靠，避免常见的错误。
