Loading...
--- Libc/Libc-583/stdlib/strtoul.3
+++ Libc/Libc-262/stdlib/strtoul.3
@@ -34,85 +34,52 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)strtoul.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/stdlib/strtoul.3,v 1.20 2002/10/10 04:31:57 tjr Exp $
+.\" $FreeBSD: src/lib/libc/stdlib/strtoul.3,v 1.14 2001/09/11 09:39:23 ru Exp $
.\"
-.Dd November 28, 2001
+.Dd June 4, 1993
.Dt STRTOUL 3
.Os
.Sh NAME
-.Nm strtoul ,
-.Nm strtoull ,
-.Nm strtoumax ,
-.Nm strtouq
-.Nd "convert a string to an"
-.Vt "unsigned long" , "unsigned long long" , uintmax_t ,
-or
-.Vt u_quad_t
-integer
+.Nm strtoul , strtoull , strtouq
+.Nd "convert a string to an unsigned long, unsigned long long, or uquad_t integer"
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In stdlib.h
-.Ft "unsigned long"
-.Fo strtoul
-.Fa "const char *restrict str"
-.Fa "char **restrict endptr"
-.Fa "int base"
-.Fc
-.Ft "unsigned long long"
-.Fo strtoull
-.Fa "const char *restrict str"
-.Fa "char **restrict endptr"
-.Fa "int base"
-.Fc
-.In inttypes.h
-.Ft uintmax_t
-.Fo strtoumax
-.Fa "const char *restrict str"
-.Fa "char **restrict endptr"
-.Fa "int base"
-.Fc
+.In limits.h
+.Ft unsigned long
+.Fn strtoul "const char *nptr" "char **endptr" "int base"
+.Ft unsigned long long
+.Fn strtoull "const char *nptr" "char **endptr" "int base"
.In sys/types.h
.In stdlib.h
.In limits.h
.Ft u_quad_t
-.Fo strtouq
-.Fa "const char *str"
-.Fa "char **endptr"
-.Fa "int base"
-.Fc
+.Fn strtouq "const char *nptr" "char **endptr" "int base"
.Sh DESCRIPTION
The
.Fn strtoul
function
converts the string in
-.Fa str
+.Fa nptr
to an
-.Vt "unsigned long"
+.Em unsigned long
value.
The
.Fn strtoull
function
converts the string in
-.Fa str
+.Fa nptr
to an
-.Vt "unsigned long long"
-value.
-The
-.Fn strtoumax
-function
-converts the string in
-.Fa str
-to an
-.Vt uintmax_t
+.Em unsigned long long
value.
The
.Fn strtouq
function
converts the string in
-.Fa str
+.Fa nptr
to a
-.Vt u_quad_t
+.Em u_quad_t
value.
The conversion is done according to the given
.Fa base ,
@@ -131,7 +98,7 @@
.Fa base
is zero or 16,
the string may then include a
-.Dq Li 0x
+.Ql 0x
prefix,
and the number will be read in base 16; otherwise, a zero
.Fa base
@@ -140,7 +107,7 @@
in which case it is taken as 8 (octal).
.Pp
The remainder of the string is converted to an
-.Vt "unsigned long"
+.Em unsigned long
value in the obvious manner,
stopping at the end of the string
or at the first character that does not produce a valid digit
@@ -156,19 +123,18 @@
.Pp
If
.Fa endptr
-is not
-.Dv NULL ,
+is non nil,
.Fn strtoul
stores the address of the first invalid character in
.Fa *endptr .
If there were no digits at all, however,
.Fn strtoul
stores the original value of
-.Fa str
+.Fa nptr
in
.Fa *endptr .
(Thus, if
-.Fa *str
+.Fa *nptr
is not
.Ql \e0
but
@@ -178,28 +144,20 @@
on return, the entire string was valid.)
.Sh RETURN VALUES
The
-.Fn strtoul ,
-.Fn strtoull ,
-.Fn strtoumax
-and
-.Fn strtouq
-functions
-return either the result of the conversion
+.Fn strtoul
+or
+.Fn strtoull
+function
+returns either the result of the conversion
or, if there was a leading minus sign,
the negation of the result of the conversion,
unless the original (non-negated) value would overflow;
in the latter case,
.Fn strtoul
returns
-.Dv ULONG_MAX ,
+.Dv ULONG_MAX
+and
.Fn strtoull
-returns
-.Dv ULLONG_MAX ,
-.Fn strtoumax
-returns
-.Dv UINTMAX_MAX ,
-and
-.Fn strtouq
returns
.Dv ULLONG_MAX .
In all cases,
@@ -221,21 +179,8 @@
.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 strtoul
-and
-.Fn strtoull
-functions.
.Sh SEE ALSO
-.Xr strtol 3 ,
-.Xr strtol_l 3 ,
-.Xr wcstoul 3 ,
-.Xr compat 5
+.Xr strtol 3
.Sh STANDARDS
The
.Fn strtoul
@@ -244,12 +189,10 @@
.St -isoC .
The
.Fn strtoull
-and
-.Fn strtoumax
-functions
-conform to
+function
+conforms to
.St -isoC-99 .
The
.Bx
-.Fn strtouq
+.Fn strtoq
function is deprecated.