nl_langinfo(3)                                           nl_langinfo(3)

  nl_langinfo()

  NAME

    nl_langinfo - language information

  SYNOPSIS

    #include 

    char * nl_langinfo(nl_item item)

  DESCRIPTION

    The nl_langinfo(3) function returns a pointer to a string containing
    information relevant to the particular language or cultural area defined
    in the program's locale (see ). The manifest constant names
    and values of item are defined in . For example:

    nl_langinfo (ABDAY_1)

    would return a pointer to the string "Dom" if the identified language was
    Portuguese, and "Sun" if the identified language was English.

    Calls to setlocale(3) with a category corresponding to the category of
    item (see ), or to the category LC_ALL, may overwrite the
    array pointed to by the return value.

  RETURN VALUE

    In a locale where langinfo data is not defined, nl_langinfo(3) returns a
    pointer to the corresponding string in the POSIX locale. In all locales,
    nl_langinfo(3) returns a pointer to an empty string if item contains an
    invalid setting.

    This pointer may point to static data that may be overwritten on the next
    call.

  SEE ALSO

    setlocale(3)

  USAGE NOTES

    The nl_langinfo function is not thread safe.

    The nl_langinfo function is not async-signal safe.