PHP nl_langinfo() Function

Description

The nl_langinfo() function is used to access specific local information.

Note: This function is not implemented on Windows platforms and hence won't work.

The following table summarizes the technical details of this function.

Return Value:	Returns the specific information on success, or `FALSE` on failure.
Version:	PHP 4.1.0+

Syntax

The basic syntax of the nl_langinfo() function is given with:

nl_langinfo(item);

The following example shows the nl_langinfo() function in action.

Example

Run this code »

<?php
// Returns the name of the character encoding
echo nl_langinfo(CODESET);
?>

Tip: Unlike localeconv() function, which returns all of the elements of locale formatting information, nl_langinfo() allows you to access any specific element.

Parameters

The nl_langinfo() function accepts the following parameters.

Parameter	Description
item	Required. Specifies which item's information to return.

An item may be an integer value of the element or the constant name of the element.

The following is a list of constant names for item that may be used and their description. Some of these constants may not be defined or hold no value for certain locales.

Constant	Description
LC_TIME Category Constants
`ABDAY_(1-7)`	Abbreviated name of n-th day of the week.
`DAY_(1-7)`	Name of the n-th day of the week (DAY_1 = Sunday).
`ABMON_(1-12)`	Abbreviated name of the n-th month of the year.
`MON_(1-12)`	Name of the n-th month of the year.
`AM_STR`	String for Ante meridian.
`PM_STR`	String for Post meridian.
`D_T_FMT`	String that can be used as the format string for `strftime()` to represent time and date.
`D_FMT`	String that can be used as the format string for `strftime()` to represent date.
`T_FMT`	String that can be used as the format string for `strftime()` to represent time.
`T_FMT_AMPM`	String that can be used as the format string for `strftime()` to represent time in 12-hour format with ante/post meridian.
`ERA`	Alternate era.
`ERA_YEAR`	Year in alternate era format.
`ERA_D_T_FMT`	Date and time in alternate era format (string can be used in `strftime()`).
`ERA_D_FMT`	Date in alternate era format (string can be used in `strftime()`).
`ERA_T_FMT`	Time in alternate era format (string can be used in `strftime()`).
LC_MONETARY Category Constants
`INT_CURR_SYMBOL`	International currency symbol.
`CURRENCY_SYMBOL`	Local currency symbol.
`CRNCYSTR`	Same value as `CURRENCY_SYMBOL`.
`MON_DECIMAL_POINT`	Decimal point character.
`MON_THOUSANDS_SEP`	Thousands separator (groups of three digits).
`MON_GROUPING`	Like `"grouping"` element.
`POSITIVE_SIGN`	Sign for positive values.
`NEGATIVE_SIGN`	Sign for negative values.
`INT_FRAC_DIGITS`	International fractional digits.
`FRAC_DIGITS`	Local fractional digits.
`P_CS_PRECEDES`	Returns 1 if currency symbol precedes a positive value.
`P_SEP_BY_SPACE`	Returns 1 if a space separates currency symbol from a positive value.
`N_CS_PRECEDES`	Returns 1 if currency symbol precedes a negative value.
`N_SEP_BY_SPACE`	Returns 1 if a space separates currency symbol from a negative value.
`P_SIGN_POSN`	Returns 0 if parentheses surround the quantity and currency symbol. Returns 1 if the sign string precedes the quantity and currency symbol. Returns 2 if the sign string follows the quantity and currency symbol. Returns 3 if the sign string immediately precedes the currency symbol. Returns 4 if the sign string immediately follows the currency symbol.
`N_SIGN_POSN`
LC_NUMERIC Category Constants
`DECIMAL_POINT`	Decimal point character.
`RADIXCHAR`	Same value as `DECIMAL_POINT`.
`THOUSANDS_SEP`	Separator character for thousands (groups of three digits).
`THOUSEP`	Same value as `THOUSANDS_SEP`.
`GROUPING`
LC_MESSAGES Category Constants
`YESEXPR`	Regex string for matching `"yes"` input.
`NOEXPR`	Regex string for matching `"no"` input.
`YESSTR`	Output string for `"yes"`.
`NOSTR`	Output string for `"no"`.
LC_CTYPE Category Constants
`CODESET`	Return a string with the name of the character encoding.

Previous Page Next Page