--- atol.3.orig 2007-04-08 18:49:34.000000000 -0700 +++ atol.3 2007-04-08 19:21:38.000000000 -0700 @@ -40,7 +40,8 @@ .Dt ATOL 3 .Os .Sh NAME -.Nm atol , atoll +.Nm atol , atoll , +.Nm atol_l , atoll_l .Nd convert .Tn ASCII string to @@ -53,14 +54,19 @@ .Sh SYNOPSIS .In stdlib.h .Ft long -.Fn atol "const char *nptr" +.Fn atol "const char *str" .Ft "long long" -.Fn atoll "const char *nptr" +.Fn atoll "const char *str" +.In xlocale.h +.Ft long +.Fn atol_l "const char *str" "locale_t loc" +.Ft "long long" +.Fn atoll_l "const char *str" "locale_t loc" .Sh DESCRIPTION The .Fn atol function converts the initial portion of the string pointed to by -.Fa nptr +.Fa str to .Vt long integer @@ -68,12 +74,12 @@ .Pp It is equivalent to: .Pp -.Dl "strtol(nptr, (char **)NULL, 10);" +.Dl "strtol(str, (char **)NULL, 10);" .Pp The .Fn atoll function converts the initial portion of the string pointed to by -.Fa nptr +.Fa str to .Vt "long long" integer @@ -81,7 +87,19 @@ .Pp It is equivalent to: .Pp -.Dl "strtoll(nptr, (char **)NULL, 10);" +.Dl "strtoll(str, (char **)NULL, 10);" +.Pp +While the +.Fn atol +and +.Fn atoll +functions use the current locale, the +.Fn atol_l +and +.Fn atoll_l +functions may be passed locales directly. See +.Xr xlocale 3 +for more information. .Sh ERRORS The functions .Fn atol @@ -96,7 +114,8 @@ .Xr atoi 3 , .Xr strtod 3 , .Xr strtol 3 , -.Xr strtoul 3 +.Xr strtoul 3 , +.Xr xlocale 3 .Sh STANDARDS The .Fn atol