atoi, atol, atoll

str が指すバイト文字列内の整数値を解釈します。暗黙の基数は常に 10 です。

空白文字が最初の非空白文字が見つかるまで破棄され、その後、有効な整数数値表現を形成するために可能な限り多くの文字を取り、それらを整数値に変換します。有効な整数値は以下の部分で構成されます：

• (optional) プラスまたはマイナス記号
• 数値の桁

結果の値が表現できない場合、すなわち変換された値が対応する戻り値の型の範囲から外れる場合、動作は未定義です。

パラメータ

戻り値

成功時の str の内容に対応する整数値。

変換が実行できない場合、 ​ 0 ​ が返されます。

注記

この名前は「ASCIIから整数へ」を意味します。

例

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    printf("%i\n", atoi(" -123junk"));
    printf("%i\n", atoi(" +321dust"));
    printf("%i\n", atoi("0"));
    printf("%i\n", atoi("0042")); // 先頭のゼロを持つ10進数として扱われる
    printf("%i\n", atoi("0x2A")); // 先頭のゼロのみが変換され、"x2A"は破棄される
    printf("%i\n", atoi("junk")); // 変換を実行できない
    printf("%i\n", atoi("2147483648")); // UB: intの範囲外
}

-123
321
0
42
0
0
-2147483648

参考文献

関連項目