Locale::composeLocale
locale_compose
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Locale::composeLocale -- locale_compose — Повертає коректно відсортовані та розділені ідентифікатори локалі
Опис
Об'єктно-орієнтований стиль
public static Locale::composeLocale(array $subtags): string|false
Процедурний стиль
locale_compose(array $subtags): string|false
Повертає рядок, що складається з коректно відсортованих і розділених ідентифікаторів локалі, зібрану з масиву, ключі якого позначають підтеги ідентифікатора, а відповідні значення цих підтегів.
Список параметрів
subtags
Масив (array), що містить список пар ключ-значення, де ключі є іменами підтегів ідентифікатора локалі, а значення відповідно значеннями цих підтегів.
Зауваження :
Подтегов
'variant'и'private'може бути не більше 15, підтегів'extlang'трохи більше 3 і т.д. Варіанти допустимі із суфіксами від 0 до 14. Ключі для цього підтегу мають називатися так:variant0variant1variant14. У ідентифікаторі локалі вкладений тег упорядкований по суфіксу, в результаті чого слідvariant0, за яким слідуєvariant1, за яким слідуєvariant2и так далее.Як альтернатива, множинні підтеги
'variant''private'и'extlang'можна задати у вигляді масиву під відповідним ключем (наприклад'variant'). У цьому випадку обмеження на кількість розпізнаних вкладених тегів не застосовуються.
Значення, що повертаються
Відповідний ідентифікатор локалі або false, якщо параметр subtagsне задан.
Приклади
Приклад #1 Приклад використання locale_compose()****
Приклад #2 Приклад використання в об'єктно-орієнтованому стилі
Результат виконання наведеного прикладу:
Locale: en_Hans_CN_nedis_rozaj_x_prv1_prv2
Приклад #3 Межі підтегів
Якщо subtags задані як окремі ключі з числовим суфіксом, ключі, що не підтримуються, ігноруються (в даному випадку 'extlang3') і впорядковуються в результаті за числовим суфіксом. Немає обмежень, якщо вкладені теги задані як масив (array); упорядковані як зазначені.
Результат виконання наведеного прикладу:
en_a_b_c_Hans_CN
en_a_b_c_d_Hans_CN
Дивіться також
- locale_parse() - Отримати асоціативний масив усіх підтегів локалі