NLANGINFO(3)           BSD Library Functions Manual           NLANGINFO(3)

NAME
     nllanginfo, nllanginfol -- language information

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##include <>

     char *
     nllanginfo(nlitem item);

     ##include <>

     char *
     nllanginfol(nlitem item, localet loc);

DESCRIPTION
     The nllanginfo() 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 setlocale() with a category corresponding to the category of
     item, or to the category LCAL, may overwrite buffer pointed by the
     return value.

EXAMPLES
     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 nllanginfo() function uses the current locale, the
     nllanginfol() function may be passed a locale directly. See xlocale(3)
     for more information.

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

SEE ALSO
     setlocale(3), xlocale(3)

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

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

BSD                               May 3, 2001                              BSD