HP 3000 Manuals

strtoul [ HP C/iX Library Reference Manual ] MPE/iX 5.0 Documentation


HP C/iX Library Reference Manual

strtoul 

Converts a string to an unsigned long int representation.

Syntax 

     #include <stdlib.h>
     unsigned long int strtoul (const char *str,
                                char **ptr,  int base);

Parameters 

str           A pointer to a character string to be converted.  If base 
              is set to zero, leading characters in str define the
              conversion.  After an optional leading sign, a leading zero
              indicates octal conversion, and a leading "0x" or "0X"
              indicates hexadecimal conversion.  Otherwise, decimal
              conversion is used.

ptr           If ptr is not NULL, a pointer to the character terminating
              the scan is stored in the object pointed to by ptr.

base          If base is between 2 and 36, it is used as the base for
              conversion.  After an optional leading sign, leading zeros
              are ignored, and "0x" or "0X" is ignored if base is 16.  If
              base is set to zero, the string itself determines the base.

Return Values 

!=0           A string value converted to a long integer.

0             When *ptr is set to str and a value of zero is returned, it
              indicates that no number can be formed.

ULONG_MAX     The conversion would cause an overflow; errno is set to
              ERANGE.

Description 

The strtoul function returns as an unsigned long int the value
represented by the character string pointed to by str.

See Also 

strtod(), strtol(), atof(), ANSI C 4.10.1.6



MPE/iX 5.0 Documentation