Strtol - Analog Devices VISUALDSP++ 3.5 Manual

C Run-Time Library Reference

strtol

convert string to long integer
Synopsis
#include <stdlib.h>
long int strtol(const char *nptr, char **endptr, int base);
Description
The function returns as a
strtol
by the string
nptr
to the unconverted remainder in
The function breaks down the input into three sections: white
strtol
space (as determined by
characters, including a terminating null character. The initial characters
may comprise an optional sign character,
those letters and digits which represent an integer with a radix of
The letters (
a-z
only when those values are less than the value of
If is zero, the base is taken from the initial characters. A leading
base
indicates base 16; a leading 0 indicates base 8. For any other leading char-
acters, base 10 is used. If
conversion.
Error Conditions
The function returns a zero if no conversion can be made and the
strtol
invalid string is stored in the object pointed to by
value results in an overflow, positive or negative (as appropriate)
is returned. If the correct value results in an underflow,
returned.
ERANGE
underflow.
3-142
long int
. If is not a null pointer,
endptr
*endptr
), initial characters, and unrecognized
isspace
or ) are assigned the values 10 to 35 and are permitted
A-Z
is between 2 and 36, it is used as a base for
base
is stored in
errno
VisualDSP++ 3.5 C/C++ Compiler and Library Manual
the value that was represented
strtol
.
or , when
0x 0X
.
base
endptr
in the case of either overflow or
for ADSP-219x DSPs
stores a pointer
is 16, and
base
.
base
0x
. If the correct
LONG_MAX
is
LONG_MIN