atoi

The atoi (ASCII to integer) function in the C programming language is used to convert a string into a numerical representation.

int atoi(const char *str)

The str argument is a string, represented by an array of characters, containing the characters of a signed integer number. The string must be null-terminated. When atoi encounters a string with no numerical sequence, it returns zero (0). If the string holds a valid sequence of digits that represents the number 0, it also returns a 0, making it impossible to tell from the return value alone whether the string holds a valid number or not. The newer function strtol does not have this deficiency.

Variants of the atoi function, atol, atof, and atoll (the latter formerly known as atoq), are used to convert a string into a long, double, or long long type, respectively:

long atol(const char *str)

double atof(const char *str)

long long atoll(const char *str) (C99)

Standards conformance

The atoi, atof, and atol functions are a part of the ISO standard C library (C89), while the atoll function is added by C99.

See also

• atof
• itoa
• strtod
• strtol