| strtol.3 (73088) | strtol.3 (73152) |
|---|---|
| 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 | 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 $ | 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 | 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 | 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" | 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" |
|
| 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 | 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 |
|
| 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 . | 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 . |
| 148In both cases, | 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, |
| 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 . | 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. |
|
| 169.Sh BUGS 170Ignores the current locale. | 200.Sh BUGS 201Ignores the current locale. |