array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'locale.composelocale.php', 1 => 'Locale::composeLocale', 2 => 'Retorna un identificador de configuración regional correcto', ), 'up' => array ( 0 => 'class.locale.php', 1 => 'Locale', ), 'prev' => array ( 0 => 'locale.canonicalize.php', 1 => 'Locale::canonicalize', ), 'next' => array ( 0 => 'locale.filtermatches.php', 1 => 'Locale::filterMatches', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/intl/locale/compose-locale.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Locale::composeLocale

locale_compose

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Locale::composeLocale -- locale_compose — Retorna un identificador de configuración regional correcto

Descripción

Estilo orientado a objetos

public static Locale::composeLocale(array $subtags): string|false

Estilo procedimental

locale_compose(array $subtags): string|false

Retorna un identificador de configuración regional correcto, ordenado y delimitado, con las claves para identificar las particularidades regionales, y los valores asociados a estas subconfiguraciones regionales.

Parámetros

subtags

Un array que contiene la lista de pares clave-valor, donde las claves representan los identificadores de subconfiguraciones regionales, y sus valores asociados son los valores de los subtags.

Nota:

Los subtags 'variant' y 'private' pueden tomar hasta 15 valores mientras que 'extlang' no puede tomar más de 3 valores. Por ejemplo, las variantes están permitidas con un sufijo que va de 0 a 14. Por lo tanto, las claves del array son variant0, variant1, …, variant14. En el identificador de configuración regional retornado, los subtags están ordenados por sufijo, con variant0 seguido de variant1 seguido de variant2 y así sucesivamente.

Alternativamente, los valores de 'variant', 'private' y 'extlang' pueden ser especificados como un array bajo una clave específica (por ejemplo, 'variant'). En este caso no se aplica ninguna limitación sobre el número de subtags reconocidos.

Valores devueltos

El identificador de configuración regional correspondiente, o false cuando subtags está vacío.

Ejemplos

Ejemplo #1 Ejemplo con locale_compose(), procedimental

<?php
$arr = array(
'language'=>'en',
'script' =>'Hans',
'region' =>'CN',
'variant2'=>'rozaj',
'variant1'=>'nedis',
'private1'=>'prv1',
'private2'=>'prv2'
);
echo locale_compose($arr);
?>

Ejemplo #2 Ejemplo con locale_compose(), POO

<?php
$arr = array(
'language'=>'en',
'script' =>'Hans',
'region' =>'CN',
'variant2'=>'rozaj',
'variant1'=>'nedis',
'private1'=>'prv1',
'private2'=>'prv2'
);
echo Locale::composeLocale($arr);
?>

El ejemplo anterior mostrará:

Locale: en_Hans_CN_nedis_rozaj_x_prv1_prv2

Ejemplo #3 Límites de los Subtags

Si subtags se proporciona como claves diferentes con un sufijo numérico, las claves no soportadas son ignoradas silenciosamente (en este caso 'extlang3'), y ordenadas en el resultado por el sufijo numérico. No hay límites, si los subtags se proporcionan como array; su orden es como se indica.

<?php
$arr = array(
'language' => 'en',
'script' => 'Hans',
'region' => 'CN',
'extlang3' => 'd',
'extlang2' => 'c',
'extlang1' => 'b',
'extlang0' => 'a',
);
echo locale_compose($arr), PHP_EOL;
$arr = array(
'language' => 'en',
'script' => 'Hans',
'region' => 'CN',
'extlang' => ['a', 'b', 'c', 'd'],
);
echo locale_compose($arr), PHP_EOL;
?>

El ejemplo anterior mostrará:

en_a_b_c_Hans_CN
en_a_b_c_d_Hans_CN

Ver también