Blog : PHP localeconv() Function

PHP localeconv() Function

--------------------------------------------------------------------------------
 Complete PHP String Reference
--------------------------------------------------------------------------------

Definition and Usage
The localeconv() function returns an array containing local numeric and monetary formatting information.

The localeconv() function will return the following array elements:

[decimal_point] - Decimal point character
[thousands_sep] - Thousands separator
[int_curr_symbol] - Currency symbol (example: USD)
[currency_symbol] - Currency symbol (example: $)
[mon_decimal_point] - Monetary decimal point character
[mon_thousands_sep] - Monetary thousands separator
[positive_sign] - Positive value character
[negative_sign] - Negative value character
[int_frac_digits] - International fractional digits
[frac_digits] - Local fractional digits
[p_cs_precedes] - True (1) if currency symbol is placed in front of a positive value, False (0) if it is placed behind
[p_sep_by_space] - True (1) if there is a spaces between the currency symbol and a positive value, False (0) otherwise
[n_cs_precedes] - True (1) if currency symbol is placed in front of a negative value, False (0) if it is placed behind
[n_sep_by_space] - True (1) if there is a spaces between the currency symbol and a negative value, False (0) otherwise
[p_sign_posn] - Formatting options:
0 - Parentheses surround the quantity and currency symbol
1 - The + sign is placed in front of the quantity and currency symbol
2 - The + sign is placed after the quantity and currency symbol
3 - The + sign is placed immediately in front of the currency symbol
4 - The + sign is placed immediately after the currency symbol
[n_sign_posn] - Formatting options:
0 - Parentheses surround the quantity and currency symbol
1 - The - sign is placed in front of the quantity and currency symbol
2 - The - sign is placed after the quantity and currency symbol
3 - The - sign is placed immediately in front of the currency symbol
4 - The - sign is placed immediately after the currency symbol
[grouping] - Array displaying how numbers are grouped (example: 3 indicates 1 000 000)
[mon_grouping] - Array displaying how monetary numbers are grouped (example: 2 indicates 1 00 00 00)
Syntax
localeconv()  


--------------------------------------------------------------------------------

Tips and Notes
Tip: To define locale settings, see the setlocale() function.


--------------------------------------------------------------------------------

Example
In this example we will find the United States locale numeric formatting information:

setlocale(LC_ALL, 'US');
$locale_info = localeconv();
print_r($locale_info);
?>  

The output of the code above will be:

Array
(
[decimal_point] => .
[thousands_sep] => ,
[int_curr_symbol] => USD
[currency_symbol] => $
[mon_decimal_point] => .
[mon_thousands_sep] => ,
[positive_sign] =>
[negative_sign] => -
[int_frac_digits] => 2
[frac_digits] => 2
[p_cs_precedes] => 1
[p_sep_by_space] => 0
[n_cs_precedes] => 1
[n_sep_by_space] => 0
[p_sign_posn] => 3
[n_sign_posn] => 0
[grouping] => Array ([0] => 3)
[mon_grouping] => Array ([0] => 3)
)