Syntax

  #include <limits.h>  
  #include <stdlib.h>  
   
  long int  strtol  (  
     const char    *ptr,   
     char         **endptr,   
     int            base);
  

Parameters

ptr

(IN) Points to the string to be converted to an object.

endptr

(OUT) Points to the first unrecognized character.

base

(IN) Specifies the base of the value being converted.

Return Values

strtol returns the converted value. If the correct value would cause overflow, LONG_MAX or LONG_MIN is returned according to the sign, and errno is set to ERANGE. If base is out of range, zero is returned and errno is set to EDOM. A value of 0 is returned when the input string cannot be converted. When an error has occurred, errno is set.

Remarks

The strtol function converts the string pointed to by ptr to an object of type long int. The function recognizes a string containing:

The conversion ends at the first unrecognized character. A pointer to that character is stored in the object to which endptr points if endptr is not NULL.

The base parameter must have a value between 2 and 36. The letters a through z and A through 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 can optionally precede the sequence of letters and digits.

See Also

ltoa, strtoul

Example

  #include <limits.h>  
  #include <stdlib.h>  
   
  main ()  
  {  
     long int v;  
     v = strtol ("12345678", NULL, 10);  
  }