
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Watcom C Library Reference - <u>synopsis:</u>
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Synopsis:
#include <stdlib.h>
unsigned long int strtoul( const char *ptr,
char **endptr,
int base );
#include <wchar.h>
unsigned long int wcstoul( const wchar_t *ptr,
wchar_t **endptr,
int base );
Description:
The strtoul function converts the string pointed to by ptr to an
unsigned long. The function recognizes a string containing optional
white space, an optional sign (+ or -), followed by a sequence of digits
and letters. The conversion ends at the first unrecognized character.
A pointer to that character will be stored in the object endptr points
to if endptr is not NULL.
If base is zero, the first characters determine the base used for the
conversion. If the first characters are "0x" or "0X" the digits are
treated as hexadecimal. If the first character is '0', the digits are
treated as octal. Otherwise the digits are treated as decimal.
If base is not zero, it must have a value of between 2 and 36. The
letters a-z and A-Z represent the values 10 through 35. Only those
letters whose designated values are less than base are permitted. If
the value of base is 16, the characters "0x" or "0X" may optionally
precede the sequence of letters and digits.
If there is a leading minus sign in the string, the value is negated.
The wcstoul function is a wide-character version of strtoul that
operates with wide-character strings.
Returns:
The strtoul function returns the converted value. If the correct value
would cause overflow, ULONG_MAX is returned and errno is set to
ERANGE. If base is out of range, zero is returned and errno is set to
EDOM.
Example:
#include <stdlib.h>
void main()
{
unsigned long int v;
v = strtoul( "12345678", NULL, 10 );
}
Classification:
strtoul is ANSI, wcstoul is ANSI
Systems:
strtoul - All, Netware
wcstoul - All
See Also:
atoi, atol, itoa, ltoa, sscanf, strtol, ultoa, utoa
See Also:
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson