[函数]mb_substitute_character()函数—用法及示例

函数名：mb_substitute_character()

适用版本：PHP 4 >= 4.0.6, PHP 5, PHP 7

用法：mb_substitute_character() 函数用于设置或获取替代字符的代码点。

语法：mb_substitute_character([int $substitute_character = -1])

参数：

• $substitute_character（可选）：要设置的替代字符的代码点，如果不传入该参数，则返回当前的替代字符的代码点。默认值为-1，表示不进行替代。

返回值：

• 如果传入了 $substitute_character 参数，则返回之前的替代字符的代码点。
• 如果没有传入参数，则返回当前的替代字符的代码点。

示例1：设置替代字符的代码点为0xFFFD（Unicode 替代字符）并返回之前的代码点。

$previous = mb_substitute_character(0xFFFD);
echo "之前的替代字符代码点为：" . $previous; // 输出：之前的替代字符代码点为：63

示例2：获取当前的替代字符的代码点。

$substitute = mb_substitute_character();
echo "当前的替代字符代码点为：" . $substitute; // 输出：当前的替代字符代码点为：-1

注意事项：

• 替代字符是在处理非法字符时使用的字符。当遇到无法转换的字符时，会使用替代字符进行替代。
• 替代字符的代码点必须是有效的 Unicode 代码点，通常是一个整数。常用的替代字符代码点是0xFFFD（Unicode 替代字符）。
• 如果将替代字符的代码点设置为-1，则表示不进行替代，而是抛出一个警告或错误。
• 该函数只对使用 mbstring 扩展的 PHP 版本有效。如果未启用该扩展，则该函数将不可用。