Loading...
--- Libc/Libc-1725.40.4/stdlib/FreeBSD/strtol.3
+++ Libc/Libc-763.11/stdlib/FreeBSD/strtol.3
@@ -36,10 +36,7 @@
.Dt STRTOL 3
.Os
.Sh NAME
-.Nm strtoimax ,
-.Nm strtol ,
-.Nm strtoll ,
-.Nm strtoq
+.Nm strtol , strtoll , strtoimax , strtoq
.Nd "convert a string value to a"
.Vt long , "long long" , intmax_t
or
@@ -48,41 +45,26 @@
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
+.In stdlib.h
+.In limits.h
+.Ft long
+.Fn strtol "const char * restrict nptr" "char ** restrict endptr" "int base"
+.Ft long long
+.Fn strtoll "const char * restrict nptr" "char ** restrict endptr" "int base"
.In inttypes.h
.Ft intmax_t
-.Fo strtoimax
-.Fa "const char *restrict str"
-.Fa "char **restrict endptr"
-.Fa "int base"
-.Fc
-.In stdlib.h
-.Ft long
-.Fo strtol
-.Fa "const char *restrict str"
-.Fa "char **restrict endptr"
-.Fa "int base"
-.Fc
-.Ft long long
-.Fo strtoll
-.Fa "const char *restrict str"
-.Fa "char **restrict endptr"
-.Fa "int base"
-.Fc
+.Fn strtoimax "const char * restrict nptr" "char ** restrict endptr" "int base"
.In sys/types.h
.In stdlib.h
.In limits.h
.Ft quad_t
-.Fo strtoq
-.Fa "const char *str"
-.Fa "char **endptr"
-.Fa "int base"
-.Fc
+.Fn strtoq "const char *nptr" "char **endptr" "int base"
.Sh DESCRIPTION
The
.Fn strtol
function
converts the string in
-.Fa str
+.Fa nptr
to a
.Vt long
value.
@@ -90,7 +72,7 @@
.Fn strtoll
function
converts the string in
-.Fa str
+.Fa nptr
to a
.Vt "long long"
value.
@@ -98,7 +80,7 @@
.Fn strtoimax
function
converts the string in
-.Fa str
+.Fa nptr
to an
.Vt intmax_t
value.
@@ -106,7 +88,7 @@
.Fn strtoq
function
converts the string in
-.Fa str
+.Fa nptr
to a
.Vt quad_t
value.
@@ -161,11 +143,11 @@
If there were no digits at all, however,
.Fn strtol
stores the original value of
-.Fa str
+.Fa nptr
in
.Fa *endptr .
(Thus, if
-.Fa *str
+.Fa *nptr
is not
.Ql \e0
but
@@ -173,17 +155,11 @@
is
.Ql \e0
on return, the entire string was valid.)
-.Pp
-Extended locale versions of these functions are documented in
-.Xr strtol_l 3 .
-See
-.Xr xlocale 3
-for more information.
.Sh RETURN VALUES
The
.Fn strtol ,
.Fn strtoll ,
-.Fn strtoimax ,
+.Fn strtoimax
and
.Fn strtoq
functions
@@ -201,7 +177,7 @@
.Er ERANGE
and the function return value is clamped according
to the following table.
-.Bl -column -offset indent ".Fn strtoimax" ".Dv INTMAX_MIN" ".Dv INTMAX_MAX"
+.Bl -column -offset indent ".Fn strtoimax" ".Sy underflow" ".Sy overflow"
.It Sy Function Ta Sy underflow Ta Sy overflow
.It Fn strtol Ta Dv LONG_MIN Ta Dv LONG_MAX
.It Fn strtoll Ta Dv LLONG_MIN Ta Dv LLONG_MAX
@@ -219,25 +195,14 @@
.It Bq Er ERANGE
The given string was out of range; the value converted has been clamped.
.El
-.Sh LEGACY SYNOPSIS
-.Fd #include <stdlib.h>
-.Fd #include <limits.h>
-.Pp
-.In limits.h
-is necessary for the
-.Fn strtol
-and
-.Fn strtoll
-functions.
.Sh SEE ALSO
.Xr atof 3 ,
.Xr atoi 3 ,
.Xr atol 3 ,
.Xr strtod 3 ,
-.Xr strtol_l 3 ,
+.Xr strtonum 3 ,
.Xr strtoul 3 ,
-.Xr wcstol 3 ,
-.Xr compat 5
+.Xr wcstol 3
.Sh STANDARDS
The
.Fn strtol