mb_decode_numericentity

适用PHP版本

PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8

函数说明

mb_decode_numericentity() 函数用于将字符串中的 HTML 数字实体（例如 A 或 A）转换为对应的多字节字符。此函数通常与 mb_encode_numericentity() 配合使用，用于处理多字节编码的字符实体转换。

函数语法

string mb_decode_numericentity(string $string, array $convmap [, string $encoding = mb_internal_encoding()])

参数

• $string：需要转换的字符串，可能包含 HTML 数字实体。
• $convmap：一个转换映射数组，用于定义哪些数值范围的数字实体需要转换。格式为一个包含四个整型元素的数组数组，每个子数组元素格式如下：[code_from, code_to, offset, mask]。具体含义参见后文示例说明。
• $encoding（可选）：目标字符编码，默认使用内部编码（mb_internal_encoding()）。

返回值

返回解码后的字符串，原字符串中符合转换映射规则的数字实体被转换为对应的多字节字符，其他部分保持不变。

示例

将字符串中的数字实体转换为 UTF-8 编码的字符：

$string = "ABC";  // 数字实体形式表示的 "ABC"
$convmap = [0x0, 0x2FFFF, 0, 0xFFFF];
echo mb_decode_numericentity($string, $convmap, "UTF-8");
  

示例代码的说明

以上示例中，字符串包含了 "A"、"B"、"C" 三个字符的数字实体表示。转换映射 [0x0, 0x2FFFF, 0, 0xFFFF] 表示转换所有 Unicode 范围内的数字实体（从 0 到 0x2FFFF）。函数将这些数字实体转换为对应的 UTF-8 字符，输出结果为 ABC。