Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <stdlib.h>
    unsigned long int strtoul( const char *ptr,
                               char **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, 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.

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.

See Also:
    ltoa, strtol, ultoa

Example:
    #include <stdlib.h>

    void main()
      {
        unsigned long int v;

        v = strtoul( "12345678", NULL, 10 );
      }

Classification:
    ANSI

Systems:
    All