std::strtoimax, std::strtoumax

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ(C++17)

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

ヌル終端バイト文字列

関数
文字操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
数値形式への変換
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
文字列操作
strcpy
strncpy
strcat
strncat
strxfrm
文字列検査
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
メモリ操作
memchr
memcmp
memset
memcpy
memmove
その他
strerror

 

ヘッダ <cinttypes> で定義
std::intmax_t strtoimax(constchar* nptr, char** endptr, int base );		(C++11以上)
std::uintmax_t strtoumax(constchar* nptr, char** endptr, int base );		(C++11以上)

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

最初の非ホワイトスペース文字が見つかるまで、あらゆるホワイトスペース文字を破棄します (ホワイトスペースは 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 のロケールによって、追加の数値形式が受理されるかもしれません。

base の値が ​0​ の場合、基数は自動検出されます。 接頭辞が 0 であれば8進数、 0x または 0X であれば16進数、そうでなければ10進数です。

入力列の一部に負の符号があった場合、結果の型で単項マイナス演算子によって行われたかのように、その数字列から計算された数値の符号が反転されます。

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

nptr が空であるか、期待された形式を持たない場合、変換は行われず、 (enptr が NULL でなければ) nptr の値が endptr の指すオブジェクトに格納されます。

引数

nptr	-	解釈される NULL 終端バイト文字列を指すポインタ
endptr	-	文字へのポインタへのポインタ
base	-	解釈される整数値の基数

戻り値

• 成功した場合は str の内容に対応する整数値を返します。
• 変換した値が戻り値の型に対応する範囲の外になった場合は地域エラーが発生し (errno を ERANGE に設定し)、 INTMAX_MAX、 INTMAX_MIN、 UINTMAX_MAX または ​0​ のうち適切なものが返されます。
• 変換を行えない場合は ​0​ が返されます。

例

Run this code

#include <iostream>#include <string>#include <cinttypes>   int main(){std::string str ="helloworld";std::intmax_t val = std::strtoimax(str.c_str(), nullptr, 36);std::cout<< str <<" in base 36 is "<< val <<" in base 10\n";   char* nptr; val = std::strtoimax(str.c_str(), &nptr, 30);if(nptr !=&str[0]+ str.size())std::cout<< str <<" in base 30 is invalid."<<" The first invalid digit is '"<<*nptr <<"'\n";}

出力:

helloworld in base 36 is 1767707668033969 in base 10 helloworld in base 30 is invalid. The first invalid digit is 'w'

関連項目

stoistolstoll (C++11)(C++11)(C++11)	文字列を符号付き整数に変換します (関数)
stoulstoull (C++11)(C++11)	文字列を符号なし整数に変換します (関数)
strtolstrtoll (C++11)	バイト文字列を整数値に変換します (関数)
strtoulstrtoull (C++11)	バイト文字列を符号なし整数値に変換します (関数)
wcstoimaxwcstoumax (C++11)(C++11)	ワイド文字列を std::intmax_t または std::uintmax_t に変換します (関数)
strtofstrtodstrtold	バイト文字列を浮動小数点値に変換します (関数)
from_chars (C++17)	文字シーケンスを整数値または浮動小数点値に変換します (関数)
atoiatolatoll (C++11)	バイト文字列を整数値に変換します (関数)
strtoimax, strtoumax の C言語リファレンス