strtol(3C)

構文

#include <stdlib.h>

long strtol(const char *str, char **ptr, int base);

long long strtoll(const char *str, char **ptr, int base);

long atol(const char *str);

int atoi(const char *str);

unsigned long strtoul(const char *str, char **ptr, int base);

unsigned long long strtoull(const char *str, char **ptr, int base);

説明

strtol() または strtoul() は、 str が指す文字列を long int または unsigned long int 形式にそれぞれ変換します。 strtoll() または strtoull() は、 str が指す文字列を long long または unsigned long long 形式にそれぞれ変換します。 文字列は、底の値と矛盾する文字が検出されるまで解釈されます。 先頭の「空白」文字 ctype(3C) 内の isspace() により定義) は無視されます。 変換が行われない場合は、０ が返されます。

引き数 base が、２ 以上 36 以下の場合、その値は変換用の底の値として用いられます。 オプションの先頭符号の後に続く先頭の ０ は無視され、 base が 16 のとき、 0x や 0X は無視されます。

base が ０ の場合、文字列の内容により底が決まります。つまり、オプションの先頭符号の後に続くものが ０ であれば ８ 進数への変換が行われ、 0x や 0X であれば 16 進数への変換が行われます。 それ以外なら 10 進数への変換が行われます。

ptr の値が (char **)NULL でない場合、解釈を終了させる文字を指すポインターを ptr が指す位置に返します。 文字列から整数が生成されない場合、 ptr が指す位置に str が設定され、ゼロが返されます。

atol(str) は、 strtol(str, (char **)NULL, 10) と同様です。

atoi(str) は、 int strtol(str, (char **)NULL, 10) と同様です。

戻り値

変換が正常に終了すれば、すべての関数は変換した値を返します。

正しい値がオーバーフローを起こした場合、

atol() と atoi() は両方ともオーバーフロー条件を無視します。

その他のすべてのエラーに対しては ０ が返され、 errno にはエラーを示す値が格納されます。

エラー

次の条件のいずれかが起こると、 strtol()、 strtoul()、 strtoll()、 または strtoull() はエラーを引き起こし、 errno に以下の左側の値が格納されます。

著者

これらのインタフェースは、OSF と HP で開発されました。

参照

ctype(3C), strtod(3C), strtoimax(3C), scanf(3S), thread_safety(5)

標準準拠

strtol(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, ANSI C

atoi(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

atol(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

strtoul(): AES, SVID3, XPG4, ANSI C

strtoll(): C99

strtoull(): C99