strtoul、strtoull

ヘッダー `<stdlib.h>` で定義
unsigned long strtoul( const char* str, char** str_end, int base );		(C99まで)
unsigned long strtoul( const char* restrict str, char** restrict str_end, int base );		(C99以降)
unsigned long long strtoull( const char* restrict str, char** restrict str_end, int base );		(C99以降)

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

isspace の呼び出しによって識別される空白文字をすべて破棄し、最初の非空白文字が見つかるまでスキップします。その後、有効な基数-n（n=base）の符号なし整数値表現を形成できるだけの文字を取得し、整数値に変換します。有効な符号なし整数値は、以下の部分から構成されます。

(任意)プラスまたはマイナスの記号
(オプション) 8進数を表す接頭辞 (0) (基数が 8 または 0 の場合にのみ適用されます)
(オプション) 16進数を表す接頭辞 (0x または 0X) (基数が 16 または 0 の場合にのみ適用されます)
数字のシーケンス

baseの有効な値のセットは{0, 2, 3, ..., 36}です。基数2の整数の有効な数字のセットは{0, 1}、基数3の整数は{0, 1, 2}などです。10より大きい基数では、有効な数字にはアルファベット文字が含まれ、基数11の整数ではAaから始まり、基数36の整数ではZzまでとなります。大文字・小文字は区別されません。

現在インストールされている C ロケールによって、追加の数値形式が受け入れられる場合があります。

base の値が 0 の場合、数値基数は自動検出されます。接頭辞が 0 の場合は基数は8進数、接頭辞が 0x または 0X の場合は基数は16進数、それ以外の場合は基数は10進数になります。

入力シーケンスにマイナス記号が含まれていた場合、数字のシーケンスから計算された数値は、結果の型における単項マイナスによるかのように否定され、符号なし整数のラップアラウンド規則が適用されます。

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

成功した場合、 str の内容に対応する整数値。変換された値が対応する戻り値の型の範囲を超える場合、範囲エラーが発生し（ errno が ERANGE に設定され）、 ULONG_MAX または ULLONG_MAX が返されます。変換が実行されない場合、 0 が返されます。

[編集] 例

このコードを実行

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    const char* p = "10 200000000000000000000000000000 30 -40 - 42";
    printf("Parsing '%s':\n", p);
    char* end = NULL;
    for (unsigned long i = strtoul(p, &end, 10);
         p != end;
         i = strtoul(p, &end, 10))
    {
        printf("'%.*s' -> ", (int)(end - p), p);
        p = end;
        if (errno == ERANGE)
        {
            errno = 0;
            printf("range error, got ");
        }
        printf("%lu\n", i);
    }
    printf("After the loop p points to '%s'\n", p);
}

出力

Parsing '10 200000000000000000000000000000 30 -40 - 42':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' -40' -> 18446744073709551576
After the loop p points to ' - 42'

[編集] 参考文献

C23標準 (ISO/IEC 9899:2024)

7.24.1.7 The strtol, strtoll, strtoul, and strtoull functions (p: TBD)

C17標準 (ISO/IEC 9899:2018)

7.22.1.4 The strtol, strtoll, strtoul, and strtoull functions (p: 251-252)

C11標準 (ISO/IEC 9899:2011)

7.22.1.4 The strtol, strtoll, strtoul, and strtoull functions (p: 344-345)

C99標準 (ISO/IEC 9899:1999)

7.20.1.4 The strtol, strtoll, strtoul, and strtoull functions (p: 310-311)

C89/C90標準 (ISO/IEC 9899:1990)

4.10.1.6 The strtoul function

[編集] 関連項目

wcstoulwcstoull (C95)(C99)	ワイド文字列を符号なし整数値に変換する (関数) [編集]
atoiatolatoll (C99)	バイト文字列を整数値に変換する (関数) [編集]
strtolstrtoll (C99)	バイト文字列を整数値に変換する (関数) [編集]
C++ ドキュメント（strtoul）

コンパイラサポート
言語
ヘッダー
型サポート
プログラムユーティリティ
可変長引数関数のサポート
エラーハンドリング
動的メモリ管理
文字列ライブラリ
アルゴリズム
数値
日付と時刻のユーティリティ
入出力サポート
ローカライゼーションサポート
並行処理サポート (C11)
技術仕様
シンボルインデックス

cppreference.com

名前空間

変種

表示

操作

strtoul、strtoull

目次

[編集] パラメータ

[編集] 戻り値

[編集] 例

[編集] 参考文献

[編集] 関連項目

ナビゲーション

ツールボックス

str	-	解釈されるヌル終端バイト文字列へのポインタ
str_end	-	文字へのポインタへのポインタ。解釈された最後の文字より後の位置に設定される場合があります。
base	-	解釈される整数値の基数