PHP | IntlChar getPropertyValueName()函数

IntlChar getPropertyValueName()函数是PHP IntlChar扩展中的一个函数，它用于获取指定Unicode属性的名称。这个函数在Unicode 7.0.0中引入，支持所有Unicode版本，包括Unicode 13.0.0。

语法

IntlChar::getPropertyValueName(int $property, int $value) : string|false

参数：

• $property：必填参数，代表一个整数，表示要查找的Unicode属性，例如IntlChar::PROPERTY_UNICODE_1_NAME。
• $value：必填参数，代表一个整数，表示Unicode属性的值。

返回值：

• 当查找成功时，返回一个代表属性值名称的字符串。
• 当查找失败时，返回false。

示例

示例1：获得General_Category属性值名称

$gc = IntlChar::PROPERTY_GENERAL_CATEGORY;
$value = IntlChar::CHAR_SPACING_MARK;
$name = IntlChar::getPropertyValueName($gc, $value);
echo "The property value name of U+00A0 with $gc is $name.\n";

这段代码的输出结果是：

The property value name of U+00A0 with 0 is Space_Separator.

示例2：获得Numeric_Value属性值名称

$nv = IntlChar::PROPERTY_NUMERIC_VALUE;
$value = IntlChar::charFromUtf32(0x0032); // "2"
$name = IntlChar::getPropertyValueName($nv, $value);
echo "The property value name of \"$value\" with $nv is $name.\n";

这段代码的输出结果是：

The property value name of "2" with 1 is Numeric_Type_Decimal.

注意事项

• 当函数返回false时，表示查找失败，可通过最后一个错误码来判断原因。
• $property 和 $value 参数必须是有效的Unicode属性和属性值，否则函数会返回false。
• 在调用这个函数前，需要确保已经加载IntlChar扩展，否则会报错。可以通过extension_loaded('intl')函数来判断是否已加载IntlChar扩展。