IntlChar::getPropertyValueName

(PHP 7)

IntlChar::getPropertyValueName — Obtener el nombre Unicode para un valor de una propiedad

Descripción

public static IntlChar::getPropertyValueName ( int $property , int $value [, int $nameChoice = IntlChar::LONG_PROPERTY_NAME ] ) : string

Devuelve el nombre Unicode para un valor de una propiedad dado, como se da en el fichero de la base de datos de Unicode PropertyValueAliases.txt.

Nota:

Algunos de los nombres en PropertyValueAliases.txt solamente se pueden obtener con IntlChar::PROPERTY_GENERAL_CATEGORY_MASK, no con IntlChar::PROPERTY_GENERAL_CATEGORY. Estos son:

  • "C" / "Other"
  • "L" / "Letter"
  • "LC" / "Cased_Letter"
  • "M" / "Mark"
  • "N" / "Number"
  • "P" / "Punctuation"
  • "S" / "Symbol"
  • "Z" / "Separator"

Parámetros

property

La propiedad de Unicode a consultar (véanse las constantes IntlChar::PROPERTY_*).

Si está fuera de rango o si el método no funciona con el valor dado, devuelve FALSE.

value

El selector para un valor de la propiedad dada. Si está fuera de rango, devuelve FALSE.

En general, los valores válidos de rangos van de 0 a un máximo. Existen un par de excepciones:

  • Los valores IntlChar::PROPERTY_BLOCK comienzan en el valor IntlChar::BLOCK_CODE_BASIC_LATIN distinto de cero.
  • Los valores IntlChar::PROPERTY_CANONICAL_COMBINING_CLASS no son contiguos y su rango es 0..240.

nameChoice

El selector a obtener por su nombre. Si está fuera de rango, devuelve FALSE.

Todas las propiedades tienen un nombre largo. La mayoría tienen un nombre corto, otras no. Unicode tiene en cuenta nombres adicionales; si están presentes, serán devueltos añadiendo 1, 2, etc., a IntlChar::LONG_PROPERTY_NAME.

Valores devueltos

Devuelve el nombre, o FALSE si property o nameChoice están fuera de rango.

Si un nameChoice dado devuelve FALSE, todos los valores mayores que nameChoice devolverán FALSE, con una excepción: si se devuelve FALSE para IntlChar::SHORT_PROPERTY_NAME, entonces IntlChar::LONG_PROPERTY_NAME (y mayores) podrían aún devolver un valor distinto de FALSE.

Ejemplos

Ejemplo #1 Probar diferentes propiedades

<?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 resultado del ejemplo sería:

string(16) "Greek_And_Coptic"
string(5) "Greek"
string(16) "Greek_And_Coptic"
bool(false)