strtoul()

convert string to long unsigned integer 

Function

SYNOPSIS

#include <stdlib.h>

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

DESCRIPTION

The strtoul() function converts the string pointed to by nptr to an unsigned long int representation. This function recognizes (in order) an optional string of spaces, 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 also 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 strtoul() to convert.

endptr 

Is a result parameter that, if not NULL, is loaded with the address of the first character that strtoul() does not attempt to convert.

base 

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

RETURN VALUES

The strtoul() function returns the converted value, if there is any. If no conversion was performed, strtoul() returns a value of zero. If the converted value overflows, strtoul() returns ULONG_MAX 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(), strtol()

MKS Toolkit 9.2 Documentation Build 16.