Next: atoll, Previous: atof, Up: Stdlib [Contents][Index]

### 2.8 `atoi`, `atol`—string to integer

Synopsis

    #include <stdlib.h>
    int atoi(const char *s);
    long atol(const char *s);
    int _atoi_r(struct _reent *ptr, const char *s);
    long _atol_r(struct _reent *ptr, const char *s);

Description
`atoi` converts the initial portion of a string to an `int`. `atol` converts the initial portion of a string to a `long`.

`atoi(s)` is implemented as `(int)strtol(s, NULL, 10).` `atol(s)` is implemented as `strtol(s, NULL, 10).`

`_atoi_r` and `_atol_r` are reentrant versions of `atoi` and `atol` respectively, passing the reentrancy struct pointer.

Returns
The functions return the converted value, if any. If no conversion was made, `0` is returned.

Portability
`atoi`, `atol` are ANSI.

No supporting OS subroutines are required.