nl_langinfo

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

nl_langinfo — Query language and locale information

Description

nl_langinfo(int$item): string|false

nl_langinfo() is used to access individual elements of the locale categories. Unlike localeconv(), which returns all of the elements, nl_langinfo() allows you to select any specific element.

Parameters

item

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.

**nl_langinfo Constants**
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.

Return Values

Returns the element as a string, or false if item is not valid.

Examples

Example #1 nl_langinfo() example

<?php

var_dump(nl_langinfo(CODESET));
var_dump(nl_langinfo(YESEXPR));
?>

The above example will output something similar to:

string(14) "ANSI_X3.4-1968" string(5) "^[yY]"

Notes

Note: This function is not implemented on Windows platforms.