xref: /openbsd/lib/libc/stdlib/atol.3 (revision d32639f6)
1df930be7Sderaadt.\" Copyright (c) 1990, 1991 The Regents of the University of California.
2df930be7Sderaadt.\" All rights reserved.
3df930be7Sderaadt.\"
4df930be7Sderaadt.\" This code is derived from software contributed to Berkeley by
5df930be7Sderaadt.\" the American National Standards Committee X3, on Information
6df930be7Sderaadt.\" Processing Systems.
7df930be7Sderaadt.\"
8df930be7Sderaadt.\" Redistribution and use in source and binary forms, with or without
9df930be7Sderaadt.\" modification, are permitted provided that the following conditions
10df930be7Sderaadt.\" are met:
11df930be7Sderaadt.\" 1. Redistributions of source code must retain the above copyright
12df930be7Sderaadt.\"    notice, this list of conditions and the following disclaimer.
13df930be7Sderaadt.\" 2. Redistributions in binary form must reproduce the above copyright
14df930be7Sderaadt.\"    notice, this list of conditions and the following disclaimer in the
15df930be7Sderaadt.\"    documentation and/or other materials provided with the distribution.
166580fee3Smillert.\" 3. Neither the name of the University nor the names of its contributors
17df930be7Sderaadt.\"    may be used to endorse or promote products derived from this software
18df930be7Sderaadt.\"    without specific prior written permission.
19df930be7Sderaadt.\"
20df930be7Sderaadt.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21df930be7Sderaadt.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22df930be7Sderaadt.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23df930be7Sderaadt.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24df930be7Sderaadt.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25df930be7Sderaadt.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26df930be7Sderaadt.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27df930be7Sderaadt.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28df930be7Sderaadt.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29df930be7Sderaadt.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30df930be7Sderaadt.\" SUCH DAMAGE.
31df930be7Sderaadt.\"
32*d32639f6Sjmc.\"	$OpenBSD: atol.3,v 1.11 2022/09/11 06:38:11 jmc Exp $
33df930be7Sderaadt.\"
34*d32639f6Sjmc.Dd $Mdocdate: September 11 2022 $
35df930be7Sderaadt.Dt ATOL 3
36df930be7Sderaadt.Os
37df930be7Sderaadt.Sh NAME
38df930be7Sderaadt.Nm atol
39e34c0550Sschwarze.Nd convert ASCII string to long integer
40df930be7Sderaadt.Sh SYNOPSIS
4164d4e987Stedu.In stdlib.h
42df930be7Sderaadt.Ft long
43df930be7Sderaadt.Fn atol "const char *nptr"
44df930be7Sderaadt.Sh DESCRIPTION
45df930be7SderaadtThe
46df930be7Sderaadt.Fn atol
47df930be7Sderaadtfunction converts the initial portion of the string pointed to by
48c5a79f6dSaaron.Fa nptr
49df930be7Sderaadtto
50*d32639f6Sjmc.Vt long integer
51df930be7Sderaadtrepresentation.
52df930be7Sderaadt.Pp
53df930be7SderaadtIt is equivalent to:
54df930be7Sderaadt.Bd -literal -offset indent
55df930be7Sderaadtstrtol(nptr, (char **)NULL, 10);
56df930be7Sderaadt.Ed
57df930be7Sderaadt.Sh SEE ALSO
58df930be7Sderaadt.Xr atof 3 ,
59df930be7Sderaadt.Xr atoi 3 ,
603389e0d9Smillert.Xr atoll 3 ,
61df930be7Sderaadt.Xr strtod 3 ,
62df930be7Sderaadt.Xr strtol 3 ,
63df930be7Sderaadt.Xr strtoul 3
64df930be7Sderaadt.Sh STANDARDS
65df930be7SderaadtThe
66df930be7Sderaadt.Fn atol
67b43b9088Saaronfunction conforms to
681b0e3e11Sschwarze.St -isoC-99 .
69