wcstoimax, wcstoumax

ワイド文字列 nptr が指す符号なし整数値を解釈します。

空白文字（ iswspace を呼び出すことで識別される）を最初の非空白文字が見つかるまで破棄し、その後有効な base-n （n= 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の locale によって、追加の数値フォーマットが受け入れられる場合があります。

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

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

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

パラメータ

戻り値

成功時には str の内容に対応する整数値。変換された値が対応する戻り値の型の範囲外の場合、範囲エラーが発生し、適切に INTMAX_MAX 、 INTMAX_MIN 、 UINTMAX_MAX または ​ 0 ​ が返されます。変換が実行できない場合は ​ 0 ​ が返されます。

例

#include <errno.h>
#include <inttypes.h>
#include <stdio.h>
#include <string.h>
#include <wchar.h>
int main(void)
{
  wchar_t* endptr;
  wprintf(L"%ld\n", wcstoimax(L" -123junk", &endptr, 10)); /* 基数10                    */
  wprintf(L"%ld\n", wcstoimax(L"11111111", &endptr, 2));   /* 基数2                     */
  wprintf(L"%ld\n", wcstoimax(L"XyZ", &endptr, 36));       /* 基数36                    */
  wprintf(L"%ld\n", wcstoimax(L"010", &endptr, 0));        /* 8進数の自動検出       */
  wprintf(L"%ld\n", wcstoimax(L"10", &endptr, 0));         /* 10進数の自動検出     */
  wprintf(L"%ld\n", wcstoimax(L"0x10", &endptr, 0));       /* 16進数の自動検出 */
  /* 範囲エラー             */
  /* LONG_MAX+1 --> LONG_MAX */
  errno = 0;
  wprintf(L"%ld\n", wcstoimax(L"9223372036854775808", &endptr, 10));
  wprintf(L"%s\n", strerror(errno));
}

-123
255
44027
8
10
16
9223372036854775807
Numerical result out of range

参考文献