*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> nl_langinfo (3)              



NAME    [Toc]    [Back]

       nl_langinfo  - Return language or cultural data defined in
       the current locale

SYNOPSIS    [Toc]    [Back]

       #include <langinfo.h>

       char *nl_langinfo(
                nl_item item );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       nl_langinfo(): XSH5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies a constant name or value.

DESCRIPTION    [Toc]    [Back]

       The nl_langinfo() function returns a pointer to  a  string
       containing information relevant to the particular language
       or cultural area defined in the program's locale. The constant
 names and values that are valid for the item parameter
 are defined in the langinfo.h header file.

       The array pointed to  by  the  return  value  may  contain
       static  data  that  is  overridden  on  the  next  call to
       nl_langinfo(). This array should not be  modified  by  the
       application, only by further calls to nl_langinfo().

       The  XSH  specification does not require the nl_langinfo()
       function to be re-entrant.

RETURN VALUES    [Toc]    [Back]

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

EXAMPLES    [Toc]    [Back]

       The following example returns a pointer to the abbreviated
       name of the first day of the week in the current locale:


       This function call would return a pointer  to  the  string
       "Dom"  if the identified language was Portuguese, "Sun" if
       the identified language was English, and so on.

SEE ALSO    [Toc]    [Back]

       Functions: localeconv(3), setlocale(3), strfmon(3)

       Others: i18n_intro(5), l10n_intro(5), standards(5)

       Writing Software for the International Market

[ Back ]
 Similar pages
Name OS Title
towctrans Tru64 Convert a wide character according to a property defined in the current locale
I18N::Collate IRIX compare 8-bit scalar data according to the current locale *** WARNING: starting from the Perl version 5.003_06
nl_langinfo Linux query language and locale information
setlocale Linux set the current locale.
strcoll Linux compare two strings using the current locale
setlocale Tru64 Change or queries the program's current locale
strxfrm Tru64 Transforms string for collation in current locale
MB_CUR_MAX Linux maximum length of a multibyte character in the current locale
glgettexfilterfuncsgis IRIX return user-defined texture filtering function
confstr Tru64 Determine the current value of a specified system variable defined by a string value
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service