函数名: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 版本有效。如果未启用该扩展,则该函数将不可用。