strtol, strtoll

str が指すバイト文字列内の整数値を解釈します。

空白文字（ isspace を呼び出すことで識別される）を最初の非空白文字が見つかるまで破棄し、その後有効な base-n （n= base の場合）整数表現を形成するために可能な限りの文字を取得し、それらを整数値に変換します。有効な整数値は以下の部分で構成されます：

• （オプション） プラスまたはマイナス記号
• （オプション） 接頭辞（ 0 ）8進数を示す（基数が 8 または ​ 0 ​ の場合のみ適用）
• （オプション） 接頭辞（ 0x または 0X ）16進数を示す（基数が 16 または ​ 0 ​ の場合のみ適用）
• 数字のシーケンス

基数として有効な値の集合は {0, 2, 3, ..., 36} です。基数 2 の整数で有効な数字の集合は {0, 1} 、基数 3 の整数では {0, 1, 2} となり、以降同様です。 10 より大きい基数の場合、有効な数字には英字が含まれ、基数 11 の整数では Aa から始まり、基数 36 の整数では Zz までとなります。文字の大文字・小文字は区別されません。

現在インストールされているCの locale によって、追加の数値フォーマットが受け入れられる場合があります。

base の値が ​ 0 ​ の場合、数値の基数は自動検出されます：プレフィックスが 0 の場合は8進数、プレフィックスが 0x または 0X の場合は16進数、それ以外の場合は10進数となります。

マイナス記号が入力シーケンスの一部であった場合、数字のシーケンスから計算された数値は、 unary minus によって結果の型で否定されたかのように処理されます。

これらの関数は、 str_end が指すポインタを、最後に解釈された数値文字の次の文字を指すように設定します。 str_end がヌルポインタの場合、この処理は無視されます。

str が空であるか、期待される形式を持たない場合、変換は行われず、（ str_end がnullポインタでない場合） str の値が str_end によって指されるオブジェクトに格納されます。

パラメータ

戻り値

• 成功した場合、 str の内容に対応する整数値が返されます。
• 変換された値が対応する戻り値の型の範囲外である場合、範囲エラーが発生し（ errno が ERANGE に設定され）、 LONG_MAX 、 LONG_MIN 、 LLONG_MAX または LLONG_MIN が返されます。
• 変換が実行できない場合、 ​ 0 ​ が返されます。

例

#include <errno.h>
#include <limits.h>
#include <stdbool.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    // エラーハンドリング付きの解析
    const char* p = "10 200000000000000000000000000000 30 -40 junk";
    printf("Parsing '%s':\n", p);
    for (;;)
    {
        // errnoはライブラリ関数呼び出しによってエラーの有無に関わらず
        // 任意の非ゼロ値に設定される可能性があるため、
        // strtolによって設定されたエラーをチェックするにはクリアする必要がある
        errno = 0;
        char* end;
        const long i = strtol(p, &end, 10);
        if (p == end)
            break;
        const bool range_error = errno == ERANGE;
        printf("Extracted '%.*s', strtol returned %ld.", (int)(end-p), p, i);
        p = end;
        if (range_error)
            printf("\n --> Range error occurred.");
        putchar('\n');
    }
    printf("Unextracted leftover: '%s'\n\n", p);
    // エラーハンドリングなしの解析
    printf("\"1010\" in binary  --> %ld\n", strtol("1010", NULL, 2));
    printf("\"12\"   in octal   --> %ld\n", strtol("12",   NULL, 8));
    printf("\"A\"    in hex     --> %ld\n", strtol("A",    NULL, 16));
    printf("\"junk\" in base-36 --> %ld\n", strtol("junk", NULL, 36));
    printf("\"012\"  in auto-detected base --> %ld\n", strtol("012",  NULL, 0));
    printf("\"0xA\"  in auto-detected base --> %ld\n", strtol("0xA",  NULL, 0));
    printf("\"junk\" in auto-detected base --> %ld\n", strtol("junk", NULL, 0));
}

Parsing '10 200000000000000000000000000000 30 -40 junk':
Extracted '10', strtol returned 10.
Extracted ' 200000000000000000000000000000', strtol returned 9223372036854775807.
 --> Range error occurred.
Extracted ' 30', strtol returned 30.
Extracted ' -40', strtol returned -40.
Unextracted leftover: ' junk'
"1010" in binary  --> 10
"12"   in octal   --> 10
"A"    in hex     --> 10
"junk" in base-36 --> 926192
"012"  in auto-detected base --> 10
"0xA"  in auto-detected base --> 10
"junk" in auto-detected base --> 0

参考文献

関連項目