(PHP 7, PHP 8)
IntlChar::getPropertyValueName — Devuelve el nombre Unicode para un valor de propiedad
$property
, int $value
, int $type
= IntlChar::LONG_PROPERTY_NAME): string|falseDevuelve el nombre Unicode para un valor de propiedad dado, tal como se indica en el archivo de base de datos Unicode PropertyValueAliases.txt.
Nota:
Algunos nombres en PropertyValueAliases.txt solo pueden obtenerse utilizando
IntlChar::PROPERTY_GENERAL_CATEGORY_MASK
, noIntlChar::PROPERTY_GENERAL_CATEGORY
. Estos incluyen:
- "C" / "Otro"
- "L" / "Letra"
- "LC" / "Letra_Mayúscula"
- "M" / "Marca"
- "N" / "Número"
- "P" / "Puntuación"
- "S" / "Símbolo"
- "Z" / "Separador"
property
The Unicode property to lookup (see the IntlChar::PROPERTY_*
constants).
Si está fuera de alcance, o si este método no funciona con el valor dado, se devuelve false
.
value
El selector para un valor de la propiedad dada. Si está fuera de alcance, se devuelve false
.
En general, los valores válidos van desde 0
hasta un máximo. Hay algunas excepciones:
IntlChar::PROPERTY_BLOCK
los valores comienzan con el valor no nulo IntlChar::BLOCK_CODE_BASIC_LATIN
IntlChar::PROPERTY_CANONICAL_COMBINING_CLASS
los valores no son contiguos y van de 0 a 240.
type
El selector para el nombre a obtener. Si está fuera de alcance, se devuelve false
.
Todos los valores tienen un nombre largo. La mayoría tienen un nombre corto, pero algunos no. Unicode permite nombres
adicionales; si están presentes, se devolverán añadiendo 1, 2, etc. a IntlChar::LONG_PROPERTY_NAME
.
Devuelve el nombre, o false
si property
o type
están fuera de alcance. Devuelve null
en caso de error.
Si un type
dado devuelve false
, entonces todos los valores mayores de
type
devolverán false
, con una excepción: si false
se devuelve para
IntlChar::SHORT_PROPERTY_NAME
, entonces IntlChar::LONG_PROPERTY_NAME
(y más) aún puede devolver un valor no-false
.
Ejemplo #1 Testing different properties
<?php
var_dump(IntlChar::getPropertyValueName(IntlChar::PROPERTY_BLOCK, IntlChar::BLOCK_CODE_GREEK));
var_dump(IntlChar::getPropertyValueName(IntlChar::PROPERTY_BLOCK, IntlChar::BLOCK_CODE_GREEK, IntlChar::SHORT_PROPERTY_NAME));
var_dump(IntlChar::getPropertyValueName(IntlChar::PROPERTY_BLOCK, IntlChar::BLOCK_CODE_GREEK, IntlChar::LONG_PROPERTY_NAME));
var_dump(IntlChar::getPropertyValueName(IntlChar::PROPERTY_BLOCK, IntlChar::BLOCK_CODE_GREEK, IntlChar::LONG_PROPERTY_NAME + 1));
?>
El ejemplo anterior mostrará :
string(16) "Greek_And_Coptic" string(5) "Greek" string(16) "Greek_And_Coptic" bool(false)