(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
localeconv — Возвращает информацию о форматировании чисел
Возвращает ассоциативный массив с информацией о числовых и денежных форматах в текущей локали.
Сигнатура функции не содержит параметров.
localeconv() возвращает данные, основанные на текущей локали, установленной функцией setlocale() . Возвращаемый массив содержит следующие элементы:
| Элемент | Описание |
|---|---|
| decimal_point | Символ десятичной точки |
| thousands_sep | Разделитель групп |
| grouping | Массив, содержащий количества цифр в группах для числовых данных |
| int_curr_symbol | Международное обозначение валюты (например, RUB) |
| currency_symbol | Национальное обозначение валюты (например, руб) |
| mon_decimal_point | Символ десятичной точки в денежном формате |
| mon_thousands_sep | Разделитель групп в денежном формате |
| mon_grouping | Массив, содержащий количества цифр в группах для денежных данных |
| positive_sign | Знак для положительных чисел |
| negative_sign | Знак для отрицательных чисел |
| int_frac_digits | Число разрядов после точки (международное) |
| frac_digits | Число разрядов после точки (национальное) |
| p_cs_precedes |
true , если currency_symbol записывается перед положительным значением,
иначе false
|
| p_sep_by_space |
true , если currency_symbol отделяется от положительного
значения пробелом, иначе false
|
| n_cs_precedes |
true , если currency_symbol записывается перед отрицательным
значением, иначе false
|
| n_sep_by_space |
true , если currency_symbol отделяется от отрицательного
значения пробелом, иначе false
|
| p_sign_posn |
|
| n_sign_posn |
|
p_sign_posn и n_sign_posn содержат
строку с опциями форматирования. Каждое число представляет собой
одно из вышеперечисленных условий.
Элементы группировки содержат массивы, которые описывают способ
группировки цифр. Например, поле группировки денежных величин
в локали nl_NL (в режиме UTF-8 со знаком евро) содержит массив
из двух элементов со значениями 3 и 3.
Больший индекс массива соответствует группировке цифр, расположенных
левее. Если элемент массива равен CHAR_MAX ,
последующие цифры не группируются. Если элемент массива равен 0,
используется значение предыдущего элемента.
Пример #1 Пример использования localeconv()
<?php
if (false !== setlocale(LC_ALL, 'ru_RU.UTF-8')) {
$locale_info = localeconv();
print_r($locale_info);
}
?>Результат выполнения приведённого примера:
Array ( [decimal_point] => , [thousands_sep] => [int_curr_symbol] => RUB [currency_symbol] => руб [mon_decimal_point] => . [mon_thousands_sep] => [positive_sign] => [negative_sign] => - [int_frac_digits] => 2 [frac_digits] => 2 [p_cs_precedes] => 0 [p_sep_by_space] => 1 [n_cs_precedes] => 0 [n_sep_by_space] => 1 [p_sign_posn] => 1 [n_sign_posn] => 1 [grouping] => Array ( [0] => 3 [1] => 3 ) [mon_grouping] => Array ( [0] => 3 [1] => 3 ) )
The C99 standard modified slightly the definition of the international currency symbol, which is now 4 characters long instead of 3 in previous definitions. The fourth character will most often be an ASCII space, but its effective value is the locale-specific spacing character used for numeric grouping (i.e. the one refered by [sep_by_space] and [grouping])...