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 73088 2001-02-26 13:23:47Z ru $
38.\"
39.Dd June 4, 1993
40.Dt STRTOL 3
41.Os
42.Sh NAME
43.Nm strtol , strtoq
44.Nd convert string value to a 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.Fd #include <sys/types.h>
53.Fd #include <stdlib.h>
54.Fd #include <limits.h>
55.Ft quad_t
56.Fn strtoq "const char *nptr" "char **endptr" "int base"
57.Sh DESCRIPTION
58The
59.Fn strtol
60function
61converts the string in
62.Fa nptr
63to a
64.Em long
65value.
66The
67.Fn strtoq
68function
69converts the string in
70.Fa nptr
71to a
72.Em quad_t
73value.
74The conversion is done according to the given
--- 65 unchanged lines hidden (view full) ---
140If an underflow occurs,
141.Fn strtol
142returns
143.Dv LONG_MIN .
144If an overflow occurs,
145.Fn strtol
146returns
147.Dv LONG_MAX .
148In both cases,
149.Va errno
150is set to
151.Er ERANGE .
152.Sh ERRORS
153.Bl -tag -width Er
154.It Bq Er ERANGE
155The given string was out of range; the value converted has been clamped.
156.El
--- 4 unchanged lines hidden (view full) ---
161.Xr strtod 3 ,
162.Xr strtoul 3
163.Sh STANDARDS
164The
165.Fn strtol
166function
167conforms to
168.St -isoC .
169.Sh BUGS
170Ignores 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 73088 2001-02-26 13:23:47Z ru $
38.\"
39.Dd June 4, 1993
40.Dt STRTOL 3
41.Os
42.Sh NAME
43.Nm strtol , strtoq
44.Nd convert string value to a 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.Fd #include <sys/types.h>
53.Fd #include <stdlib.h>
54.Fd #include <limits.h>
55.Ft quad_t
56.Fn strtoq "const char *nptr" "char **endptr" "int base"
57.Sh DESCRIPTION
58The
59.Fn strtol
60function
61converts the string in
62.Fa nptr
63to a
64.Em long
65value.
66The
67.Fn strtoq
68function
69converts the string in
70.Fa nptr
71to a
72.Em quad_t
73value.
74The conversion is done according to the given
--- 65 unchanged lines hidden (view full) ---
140If an underflow occurs,
141.Fn strtol
142returns
143.Dv LONG_MIN .
144If an overflow occurs,
145.Fn strtol
146returns
147.Dv LONG_MAX .
148In both cases,
149.Va errno
150is set to
151.Er ERANGE .
152.Sh ERRORS
153.Bl -tag -width Er
154.It Bq Er ERANGE
155The given string was out of range; the value converted has been clamped.
156.El
--- 4 unchanged lines hidden (view full) ---
161.Xr strtod 3 ,
162.Xr strtoul 3
163.Sh STANDARDS
164The
165.Fn strtol
166function
167conforms to
168.St -isoC .
169.Sh BUGS
170Ignores the current locale.