Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (a - d) atol(3)
NAME
atol - Converts a character string to a long integer
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <stdlib.h>
long int atol(
const char *nptr);
PARAMETERS
nptr Points to the character string to convert.
DESCRIPTION
The atol( ) function converts the character string pointed to by the nptr parameter up to the first
character inconsistent with the format of a decimal integer to a long integer data type. Leading
white-space characters are ignored. A call to this function is equivalent to a call to strtol(nptr,
(char**) NULL, 10), except that error handling is different. The long int value of the input
string is returned.
In the TNS environment, the atol( ) function supports the C/POSIX locale only. In the native
environment, all locales are supported.
NOTES
The atol( ) function is subsumed by the strtol( ) function. If the number is not known to be in
range, strtol( ) should be used because atol( ) is not required to perform any error checking.
RETURN VALUES
The atol( ) function returns the converted value of long integer if the expected form is found. If
no conversion could be performed, a value of 0 (zero) is returned. If the converted value is out-
side the range of representable values, LONG_MAX or LONG_MIN is returned (according to
the sign of the value).
Because this function returns 0 (zero), LONG_MIN,orLONG_MAX in the event of an error
and these values are also valid returns if the function is successful, applications should set errno
to 0 (zero) before calling this function, and check errno after return from the function. If errno
is nonzero, an error occurred.
ERRORS
No error values are defined for return.
RELATED INFORMATION
Functions: atof(3), atoi(3), scanf(3), strtol(3), strtoul(3), strtoull(3), scanf(3), wcstol(3).
527187-017 Hewlett-Packard Company 1−53