strtol()

convert string to long integer 

Function

SYNOPSIS

#include <stdlib.h>

long strtol(const char *nptr, char **endptr, int base);

DESCRIPTION

The strtol() function converts the string pointed to by nptr to a long int representation. This function recognizes (in order) an optional string of spaces, an optional sign, an optional base indicator (0 for octal, X or x for hexadecimal), and a string of digits. The first unrecognized character ends the string. A pointer to this unrecognized character is stored in the object addressed by endptr, if endptr is not NULL.

If base is non-zero, its value determines the set of recognized digits and overrides the optional base indicator character. If base is zero, nptr is assumed to be base 10, unless an optional base indicator character is given.

PARAMETERS

nptr 

Points to a character string for strtol() to convert.

endptr 

Is a result parameter that, if not NULL, returns a string beginning with the first character that strtol() does not attempt to convert.

base 

Is the base of the string, a value between 0 and 36.

RETURN VALUES

The strtol() function returns the converted value, if there is any. If no conversion was performed, strtol() returns a zero. If the converted value overflows, strtol() returns LONG_MAX or LONG_MIN (according to the sign of the value) and sets errno to ERANGE.

CONFORMANCE

ANSI/ISO 9899-1990.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

None.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
atoi(), atol(), strtoul()

MKS Toolkit 9.2 Documentation Build 16.