atoi

atoi (ASCII to Integer) は、文字もじ列れつを整数せいすう型がたに変換へんかんするC言語げんごの標準ひょうじゅんCライブラリの関数かんすう。標準ひょうじゅんヘッダーファイル <stdlib.h> で宣言せんげんされている。読よみ方かたは規格きかくでは特とくに定さだめられていない。

概要がいよう

引数ひきすうで与あたえられた文字もじ列れつを解析かいせきし、文字もじ列れつ先頭せんとうの連続れんぞくする10進数しんすう整数せいすう部分ぶぶんをint型かたの整数せいすうに変換へんかんする。例たとえば、引数ひきすうに"123abc"を与あたえると戻もどり値ちとして123を返かえし、"-5"なら-5を返かえす。"abc"や""（空文字くうもじ列れつ）など変換へんかん不可能ふかのうな文字もじ列れつの場合ばあい、0を返かえす。

変換へんかんされた後のちの数値すうちがintの範囲はんいに収おさまらない（結果けっかがintで表現ひょうげんできない）場合ばあい、C99やC11の仕様しよう上じょうは未定義みていぎ動作どうさ (undefined behavior) を引ひき起おこす。また、変換へんかんに失敗しっぱいしてもerrnoを書かき換かえないかもしれない。このため、atoiの使用しようを禁止きんししているガイドラインも存在そんざいする。

正常せいじょうに変換へんかん可能かのうな文字もじ列れつの場合ばあいは (int)strtol(s, NULL, 10) と同おなじ結果けっかを返かえす。

形式けいしき

#include <stdlib.h>
int atoi(const char *nptr);

脚注きゃくちゅう

関連かんれん項目こうもく

• atof
• atol
• itoa

外部がいぶリンク

• atoi(3) – JM Project Linux Library Functions マニュアル
• atoi, atol, atoll - cppreference.com