NLLANGINFO(3) BSD Library Functions Manual NLLANGINFO(3)

NAME
     nnllllaannggiinnffoo, nnllllaannggiinnffooll - language information

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     char *
     nnllllaannggiinnffoo(nlitem item);

     ##iinncclluuddee <>

     char *
     nnllllaannggiinnffooll(nlitem item, localet loc);

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

     Calls to sseettllooccaallee() with a category corresponding to the category of
     item, or to the category LCALL, may overwrite buffer pointed by the
     return value.

EEXXAAMMPPLLEESS
     For example:

           nllanginfo(ABDAY1)

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

     While the nnllllaannggiinnffoo() function uses the current locale, the
     nnllllaannggiinnffooll() function may be passed a locale directly. See xlocale(3)
     for more information.

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

SEE ALSO
     setlocale(3), xlocale(3)

STANDARDS     The nnllllaannggiinnffoo() function conforms to Version 2 of the Single UNIX
     Specification (``SUSv2'').

HISTORY     The nnllllaannggiinnffoo() function first appeared in FreeBSD 4.6.

BSD                               May 3, 2001                              BSD