##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# atoi, atol, atoll

From cppreference.com
< c‎ | string‎ | byte

Defined in header `<stdlib.h>` |  |
int atoi( const char *str ); |  |
long atol( const char *str ); |  |
long long atoll( const char *str ); |  | (since C99)

Interprets an integer value in a byte string pointed to by `str`.

Function discards any whitespace characters until first non-whitespace character is found. Then it takes as many characters as possible to form a valid integer number representation and converts them to integer value. The valid integer value consists of the following parts:

- (optional) plus or minus sign
- numeric digits

### [edit] Parameters

str | - | pointer to the null-terminated byte string to be interpreted

### [edit] Return value

Integer value corresponding to the contents of `str` on success. If the converted value falls out of range of corresponding return type, the return value is undefined. If no conversion can be performed, ​0​ is returned.

### [edit] Example

Run this code

    #include <stdio.h>
    #include <stdlib.h>

    int main(void)
    {
        printf("%i\n", atoi(" -123junk"));
    }

Output:

    -123

### [edit] See also

strtol strtoll | converts a byte string to an integer value (function) [edit]
strtoul strtoull | converts a byte string to an unsigned integer value (function) [edit]
C++ documentation for atoi, atol, atoll

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=c/string/byte/atoi&oldid=70082"