Internationalization IntlChar::getPropertyValueName

(PHP 7, PHP 8)

IntlChar::getPropertyValueName — 속성 값의 유니코드 이름 가져오기


설명

public static IntlChar::getPropertyValueName(int $property, int $value, int $type = IntlChar::LONG_PROPERTY_NAME): string|false

유니코드 데이터베이스 파일 PropertyValueAliases.txt에 지정된 대로 지정된 속성 값에 대한 유니코드 이름을 반환합니다.

메모:

PropertyValueAliases.txt의 일부 이름은 IntlChar::PROPERTY_GENERAL_CATEGORY_MASK를 사용해서만 검색할 수 있으며 IntlChar::PROPERTY_GENERAL_CATEGORY는 사용할 수 없습니다. 여기에는 다음이 포함됩니다.

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

매개변수

property
조회할 유니코드 속성(IntlChar::PROPERTY_* 상수 참조).

범위를 벗어나거나 이 메서드가 주어진 값으로 작동하지 않으면 false가 반환됩니다.

value
주어진 속성 값에 대한 선택기입니다. 범위를 벗어나면 false가 반환됩니다.

일반적으로 유효한 값의 범위는 0에서 최대 일부입니다. 몇 가지 예외가 있습니다.

  • IntlChar::PROPERTY_BLOCK values begin at the non-zero value IntlChar::BLOCK_CODE_BASIC_LATIN
  • IntlChar::PROPERTY_CANONICAL_COMBINING_CLASS values are not contiguous and range from 0..240.
type
가져올 이름의 선택기입니다. 범위를 벗어나면 false가 반환됩니다.

모든 값에는 긴 이름이 있습니다. 대부분은 짧은 이름을 가지고 있지만 일부는 그렇지 않습니다. 유니코드는 추가 이름을 허용합니다. 존재하는 경우 IntlChar::LONG_PROPERTY_NAME에 1, 2 등을 추가하여 반환됩니다.


반환 값

이름을 반환하거나 property이나 type이 범위를 벗어나면 false를 반환합니다. 실패 시 null을 반환합니다.

지정된 typefalse를 반환하면 type의 더 큰 모든 값은 한 가지 예외를 제외하고 false를 반환합니다. IntlChar::SHORT_PROPERTY_NAME에 대해 false가 반환되면 IntlChar::LONG_PROPERTY_NAME(및 그 이상)은 여전히 false가 아닌 값을 반환할 수 있습니다.


Examples

예제 #1 다양한 속성 테스트

                  
<?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));
?>
                  
                

위의 예는 다음을 출력합니다.

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