1.\" Copyright (c) 1990, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" Chris Torek and the American National Standards Committee X3,
6.\" on Information Processing Systems.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
--- 20 unchanged lines hidden (view full) ---
29.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34.\" SUCH DAMAGE.
35.\"
36.\" @(#)strtol.3 8.1 (Berkeley) 6/4/93
37.\" $FreeBSD: head/lib/libc/stdlib/strtol.3 73152 2001-02-27 13:33:07Z obrien $
38.\"
39.Dd June 4, 1993
40.Dt STRTOL 3
41.Os
42.Sh NAME
43.Nm strtol , strtoll , strtoq
44.Nd convert string value to a long , long long , or quad_t integer
45.Sh LIBRARY
46.Lb libc
47.Sh SYNOPSIS
48.Fd #include <stdlib.h>
49.Fd #include <limits.h>
50.Ft long
51.Fn strtol "const char *nptr" "char **endptr" "int base"
52.Ft long long
53.Fn strtoll "const char *nptr" "char **endptr" "int base"
54.Fd #include <sys/types.h>
55.Fd #include <stdlib.h>
56.Fd #include <limits.h>
57.Ft quad_t
58.Fn strtoq "const char *nptr" "char **endptr" "int base"
59.Sh DESCRIPTION
60The
61.Fn strtol
62function
63converts the string in
64.Fa nptr
65to a
66.Em long
67value.
68The
69.Fn strtoll
70function
71converts the string in
72.Fa nptr
73to a
74.Em long long
75value.
76The
77.Fn strtoq
78function
79converts the string in
80.Fa nptr
81to a
82.Em quad_t
83value.
84The conversion is done according to the given
--- 65 unchanged lines hidden (view full) ---
150If an underflow occurs,
151.Fn strtol
152returns
153.Dv LONG_MIN .
154If an overflow occurs,
155.Fn strtol
156returns
157.Dv LONG_MAX .
158The
159.Fn strtoll
160function
161returns the result of the conversion,
162unless the value would underflow or overflow.
163If an underflow occurs,
164.Fn strtoll
165returns
166.Dv LLONG_MIN .
167If an overflow occurs,
168.Fn strtoll
169returns
170.Dv LLONG_MAX .
171In all cases,
172.Va errno
173is set to
174.Er ERANGE .
175.Sh ERRORS
176.Bl -tag -width Er
177.It Bq Er ERANGE
178The given string was out of range; the value converted has been clamped.
179.El
--- 4 unchanged lines hidden (view full) ---
184.Xr strtod 3 ,
185.Xr strtoul 3
186.Sh STANDARDS
187The
188.Fn strtol
189function
190conforms to
191.St -isoC .
192The
193.Fn strtoll
194function
195conforms to
196.St -isoC-99 .
197The BSD
198.Fn strtoq
199function is deprecated.
200.Sh BUGS
201Ignores the current locale.
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" Chris Torek and the American National Standards Committee X3,
6.\" on Information Processing Systems.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
--- 20 unchanged lines hidden (view full) ---
29.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34.\" SUCH DAMAGE.
35.\"
36.\" @(#)strtol.3 8.1 (Berkeley) 6/4/93
37.\" $FreeBSD: head/lib/libc/stdlib/strtol.3 73152 2001-02-27 13:33:07Z obrien $
38.\"
39.Dd June 4, 1993
40.Dt STRTOL 3
41.Os
42.Sh NAME
43.Nm strtol , strtoll , strtoq
44.Nd convert string value to a long , long long , or quad_t integer
45.Sh LIBRARY
46.Lb libc
47.Sh SYNOPSIS
48.Fd #include <stdlib.h>
49.Fd #include <limits.h>
50.Ft long
51.Fn strtol "const char *nptr" "char **endptr" "int base"
52.Ft long long
53.Fn strtoll "const char *nptr" "char **endptr" "int base"
54.Fd #include <sys/types.h>
55.Fd #include <stdlib.h>
56.Fd #include <limits.h>
57.Ft quad_t
58.Fn strtoq "const char *nptr" "char **endptr" "int base"
59.Sh DESCRIPTION
60The
61.Fn strtol
62function
63converts the string in
64.Fa nptr
65to a
66.Em long
67value.
68The
69.Fn strtoll
70function
71converts the string in
72.Fa nptr
73to a
74.Em long long
75value.
76The
77.Fn strtoq
78function
79converts the string in
80.Fa nptr
81to a
82.Em quad_t
83value.
84The conversion is done according to the given
--- 65 unchanged lines hidden (view full) ---
150If an underflow occurs,
151.Fn strtol
152returns
153.Dv LONG_MIN .
154If an overflow occurs,
155.Fn strtol
156returns
157.Dv LONG_MAX .
158The
159.Fn strtoll
160function
161returns the result of the conversion,
162unless the value would underflow or overflow.
163If an underflow occurs,
164.Fn strtoll
165returns
166.Dv LLONG_MIN .
167If an overflow occurs,
168.Fn strtoll
169returns
170.Dv LLONG_MAX .
171In all cases,
172.Va errno
173is set to
174.Er ERANGE .
175.Sh ERRORS
176.Bl -tag -width Er
177.It Bq Er ERANGE
178The given string was out of range; the value converted has been clamped.
179.El
--- 4 unchanged lines hidden (view full) ---
184.Xr strtod 3 ,
185.Xr strtoul 3
186.Sh STANDARDS
187The
188.Fn strtol
189function
190conforms to
191.St -isoC .
192The
193.Fn strtoll
194function
195conforms to
196.St -isoC-99 .
197The BSD
198.Fn strtoq
199function is deprecated.
200.Sh BUGS
201Ignores the current locale.