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() を呼ぶことによって識別されます)。 その後、有効な base 進数の符号なし整数表現を形成する文字を可能な限り多く読み込み、それを符号なし整数値に変換します。 有効な符号なし整数値は以下のように構成されます。
- (オプション) 正または負の符号
- (オプション) 8進数を表す接頭辞
0(基数が8または0の場合のみ) - (オプション) 16進数を表す接頭辞
0xまたは0X(基数が16または0の場合のみ) - 数字の並び
基数に対する有効な値の集合は {0,2,3,...,36} です。 2進数の整数に対する有効な数字の集合は {0,1} で、3進数に対しては {0,1,2} で、以下同様です。 10 より大きな基数に対しては、有効な数字にアルファベット文字が含まれます。11進数用の Aa から始まり、36進数用の Zz までです。 大文字小文字の違いは無視されます。
現在設定されている C のsetlocaleによって、追加の数値形式が受理されるかもしれません。
base の値が 0 の場合、基数は自動検出されます。 接頭辞が 0 であれば8進数、 0x または 0X であれば16進数、そうでなければ10進数です。
入力列の一部に負の符号があった場合、結果の型で単項マイナス演算子によって行われたかのように(符号なし整数のラップアラウンドルールが適用されます)、その数字列から計算された数値の符号が反転されます。
この関数は str_end の指すポインタを、解釈した最後の文字の次の文字を指すように設定します。 str_end が NULL の場合は無視されます。
引数
| str | - | 解釈されるヌル終端バイト文字列を指すポインタ |
| str_end | - | 文字へのポインタへのポインタ |
| base | - | 解釈される整数値の基数 |
戻り値
成功した場合は、 str の内容に対応する整数値。 変換後の値が戻り値の型の範囲外の場合は、値域エラーが発生し (errno が ERANGE に設定され)、 ULONG_MAX または ULLONG_MAX が返されます。 変換が行えない場合は、 0 が返されます。
例
#include <stdio.h>
#include <errno.h>
#include <stdlib.h>
int main(void)
{
const char *p = "10 200000000000000000000000000000 30 -40";
printf("Parsing '%s':\n", p);
char *end;
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){
printf("range error, got ");
errno = 0;
}
printf("%lu\n", i);
}
}
出力:
Parsing '10 200000000000000000000000000000 30 -40':
'10' -> 10
' 200000000000000000000000000000' -> range error, got 18446744073709551615
' 30' -> 30
' -40' -> 18446744073709551576
参考文献
- C11 standard (ISO/IEC 9899:2011):
- 7.22.1.4 The strtol, strtoll, strtoul, and strtoull functions (p: 344-345)
- C99 standard (ISO/IEC 9899:1999):
- 7.20.1.4 The strtol, strtoll, strtoul, and strtoull functions (p: 310-311)
- C89/C90 standard (ISO/IEC 9899:1990):
- 4.10.1.6 The strtoul function
関連項目
(C95)(C99) |
ワイド文字列を符号無し整数値に変換します (関数) |
(C99) |
バイト文字列を整数値に変換します (関数) |
(C99) |
バイト文字列を整数値に変換します (関数) |
strtoul の C++リファレンス
|