Libc-1082.50.1.tar.gz

[apple/libc.git] / locale / FreeBSD / nl_langinfo.3

diff --git a/locale/FreeBSD/nl_langinfo.3 b/locale/FreeBSD/nl_langinfo.3
index 3fc47e0ece4b92d0542553a91ee82c627b6b3e4c..3d846deb113cff078bef484523a69e04558d5a47 100644 (file)
--- a/locale/FreeBSD/nl_langinfo.3
+++ b/locale/FreeBSD/nl_langinfo.3
@@ -22,20 +22,30 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\" $FreeBSD: src/lib/libc/locale/nl_langinfo.3,v 1.5 2003/09/08 19:57:14 ru Exp $
+.\" $FreeBSD: src/lib/libc/locale/nl_langinfo.3,v 1.7 2009/11/16 14:33:31 brueffer Exp $

 .\"
 .Dd May 3, 2001
 .Dt NL_LANGINFO 3
 .Os
 .Sh NAME
 .\"
 .Dd May 3, 2001
 .Dt NL_LANGINFO 3
 .Os
 .Sh NAME

-.Nm nl_langinfo
+.Nm nl_langinfo ,
+.Nm nl_langinfo_l

 .Nd language information
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In langinfo.h
 .Ft char *
 .Nd language information
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In langinfo.h
 .Ft char *

-.Fn nl_langinfo "nl_item item"
+.Fo nl_langinfo
+.Fa "nl_item item"
+.Fc
+.In langinfo.h
+.In xlocale.h
+.Ft char *
+.Fo nl_langinfo_l
+.Fa "nl_item item"
+.Fa "locale_t loc"
+.Fc

 .Sh DESCRIPTION
 The
 .Fn nl_langinfo
 .Sh DESCRIPTION
 The
 .Fn nl_langinfo


@@ -53,7 +63,18 @@ with a category corresponding to the category of
 or to the
 category
 .Dv LC_ALL ,
 or to the
 category
 .Dv LC_ALL ,

-may overwrite buffer pointed by the return value.
+may overwrite the buffer pointed to by the return value.
+.Sh RETURN VALUES
+In a locale where langinfo data is not defined,
+.Fn nl_langinfo
+returns a pointer to the corresponding string in the
+.Tn POSIX
+locale.
+In all locales,
+.Fn nl_langinfo
+returns a pointer to an empty string if
+.Fa item
+contains an invalid setting.

 .Sh EXAMPLES
 For example:
 .Pp
 .Sh EXAMPLES
 For example:
 .Pp


@@ -65,19 +86,17 @@ if the identified language was
 Portuguese, and
 .Qq Li Sun
 if the identified language was English.
 Portuguese, and
 .Qq Li Sun
 if the identified language was English.

-.Sh RETURN VALUES
-In a locale where langinfo data is not defined,
-.Fn nl_langinfo
-returns a pointer to the corresponding string in the
-.Tn POSIX
-locale.
-In all locales,
+.Pp
+While the

 .Fn nl_langinfo
 .Fn nl_langinfo

-returns a pointer to an empty string if
-.Fa item
-contains an invalid setting.
+function uses the current locale, the
+.Fn nl_langinfo_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.

 .Sh SEE ALSO
 .Sh SEE ALSO

-.Xr setlocale 3
+.Xr setlocale 3 ,
+.Xr xlocale 3

 .Sh STANDARDS
 The
 .Fn nl_langinfo
 .Sh STANDARDS
 The
 .Fn nl_langinfo