atoi.3.patch   [plain text]

--- atoi.3.orig	Fri Mar 11 10:13:22 2005
+++ atoi.3	Fri Mar 11 10:14:49 2005
@@ -40,7 +40,8 @@
 .Dt ATOI 3
 .Os
 .Sh NAME
-.Nm atoi
+.Nm atoi ,
+.Nm atoi_l
 .Nd convert
 .Tn ASCII
 string to integer
@@ -50,6 +51,9 @@
 .In stdlib.h
 .Ft int
 .Fn atoi "const char *nptr"
+.In xlocale.h
+.Ft int
+.Fn atoi_l "const char *nptr" "locale_t loc"
 .Sh DESCRIPTION
 The
 .Fn atoi
@@ -63,6 +67,14 @@
 .Bd -literal -offset indent
 (int)strtol(nptr, (char **)NULL, 10);
 .Ed
+.Pp
+While the
+.Fn atoi
+function uses the current locale, the
+.Fn atoi_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.
 .Sh IMPLEMENTATION NOTES
 The
 .Fn atoi
@@ -84,7 +96,8 @@
 .Xr atol 3 ,
 .Xr strtod 3 ,
 .Xr strtol 3 ,
-.Xr strtoul 3
+.Xr strtoul 3 ,
+.Xr xlocale 3
 .Sh STANDARDS
 The
 .Fn atoi