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. |