std::wscanf、std::fwscanf、std::swscanf

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

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

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

C形式I/O

型とオブジェクト
FILE fpos_t	stdinstdoutstderr
関数
ファイルアクセス fopen freopen fclose fflush fwide setbuf setvbuf 直接入出力 fread fwrite 非書式化入出力 fgetcgetc fgets fputcputc fputs getchar gets (C++14まで) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 書式付き入力 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	書式付き出力 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf ファイルポジショニング ftell fgetpos fseek fsetpos rewind エラーハンドリング clearerr feof ferror perror ファイル操作 remove rename tmpfile tmpnam

 

ヘッダ <cwchar> で定義
int wscanf( const wchar_t* format, ... );	(1)
int fwscanf( std::FILE* stream, const wchar_t* format, ... );	(2)
int swscanf( const wchar_t* buffer, const wchar_t* format, ... );	(3)

さまざまなソースからデータを読み込み、format に従って解釈し、結果を指定された場所に格納します。

1) stdin からデータを読み込みます。

2) ファイルストリーム stream からデータを読み込みます。

3) null終端ワイド文字列 buffer からデータを読み込みます。

パラメータ

stream	-	読み込む入力ファイルストリーム
buffer	-	読み込む null終端ワイド文字列へのポインタ
format	-	入力をどのように読み取るかを指定する null終端ワイド文字列へのポインタ
...	-	受信引数。

format 文字列は以下で構成されます。

• 空白文字以外のワイド文字（% を除く）: フォーマット文字列内の各このような文字は、入力ストリームから厳密に1つの同一の文字を消費するか、ストリームの次の文字が一致しない場合は関数を失敗させます。
• 空白文字: フォーマット文字列内の任意の1つの空白文字は、入力から連続するすべての利用可能な空白文字を消費します（std::iswspace をループで呼び出すのと同様に決定されます）。フォーマット文字列内の 「"\n"」、「" "」、「"\t\t"」 またはその他の空白文字の間に違いはありません。
• 変換指定。各変換指定は次の形式です。

• 先行する % 文字。

• (オプション) 代入抑制文字 *。このオプションが存在する場合、関数は変換の結果を受信引数に代入しません。

• (オプション) 整数（1より大きい）で、最大フィールド幅を指定します。これは、現在の変換指定子によって指定された変換を実行する際に、関数が消費することを許可される最大文字数です。 %s および %[ は、幅が指定されていない場合、バッファオーバーフローを引き起こす可能性があることに注意してください。

• (オプション) 受け取る引数のサイズ、つまり実際の宛先型を指定する 長さ修飾子。これは変換精度とオーバーフロー規則に影響します。デフォルトの宛先型は変換型ごとに異なります（下記の表を参照）。

• 変換フォーマット指定子。

以下のフォーマット指定子が利用可能です

変換 指定子	説明	期待される 引数型
長さ修飾子→		hh	h	なし	l	ll	j	z	t	L
C++11からのみ利用可能→		はい				はい	はい	はい	はい
%	リテラル % にマッチします。	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A
c	文字 または 文字のシーケンス にマッチします。 幅指定子が使用されている場合、厳密に *width* ワイド文字と一致します（引数は十分な容量を持つ配列へのポインタである必要があります）。 %s および %[ とは異なり、ヌル文字を配列に追加しません。	N/A	N/A	char*	wchar_t*	N/A	N/A	N/A	N/A	N/A
s	非空白文字のシーケンス（文字列）にマッチします。 幅指定子が使用されている場合、width 個まで、または最初の空白文字まで（どちらか早い方）にマッチします。 マッチした文字に加えて常にヌル文字を格納します（したがって、引数配列は少なくとも width+1 文字のスペースが必要です）。
[set ]	set 文字セットからの空でない文字シーケンスにマッチします。 セットの最初の文字が ^ の場合、セットに含まれないすべての文字にマッチします。 セットが ] または ^] で始まる場合、] 文字もセットに含まれます。 スキャンセット内の非初期位置にある - 文字が、[0-9] のように範囲を示すかどうかは、実装定義です。 幅指定子が使用されている場合、width までのみマッチします。 マッチした文字に加えて常にヌル文字を格納します（したがって、引数配列は少なくとも width+1 文字のスペースが必要です）。
d	10進整数 にマッチします。 数値のフォーマットは、10 を base 引数として、std::wcstol が期待するものと同じです。	signed char* または unsigned char*	signed short* または unsigned short*	signed int* または unsigned int*	signed long* または unsigned long*	signed long long* または unsigned long long*	std::intmax_t* または std::uintmax_t*	std::size_t*	std::ptrdiff_t*	N/A
i	整数 にマッチします。 数値のフォーマットは、​0​ を base 引数として、std::wcstol が期待するものと同じです（baseは最初に解析された文字によって決定されます）。
u	符号なし 10進整数 にマッチします。 数値のフォーマットは、10 を base 引数として、std::wcstoul が期待するものと同じです。
o	符号なし 8進整数 にマッチします。 数値のフォーマットは、8 を base 引数として、std::wcstoul が期待するものと同じです。
x X	符号なし 16進整数 にマッチします。 数値のフォーマットは、16 を base 引数として、std::wcstoul が期待するものと同じです。
n	これまでに読み取った文字数 を返します。 入力は消費されません。代入カウントは増加しません。 指定子に代入抑制演算子が定義されている場合、動作は未定義です。
a (C++11) A (C++11) e E f F (C++11) g G	浮動小数点数 にマッチします。 数値のフォーマットは、std::wcstof が期待するものと同じです。	N/A	N/A	float*	double*	N/A	N/A	N/A	N/A	long double*
p	ポインタ を定義する実装定義の文字シーケンスにマッチします。 printf ファミリの関数は、%p 書式指定子を使用して同じシーケンスを生成するはずです。	N/A	N/A	void**	N/A	N/A	N/A	N/A	N/A	N/A
注釈
n 以外のすべての変換指定子について、指定されたフィールド幅を超えず、かつ変換指定子が期待するものと完全に一致するか、または期待されるシーケンスのプレフィックスとなるような、最も長い入力文字シーケンスがストリームから消費されます。この消費されたシーケンスの後の最初の文字は、読み込まれないまま残ります。消費されたシーケンスの長さがゼロであるか、または消費されたシーケンスを上記のように変換できない場合、マッチングエラーが発生します。ただし、ストリームからの入力がエンド・オブ・ファイル、エンコーディングエラー、または読み取りエラーによって妨げられた場合は、入力エラーとなります。 [、c、n 以外のすべての変換指定子は、入力の解析を試みる前に、すべての先行する空白文字（std::iswspace を呼び出すのと同様に決定されます）を消費して破棄します。これらの消費された文字は、指定された最大フィールド幅にはカウントされません。 長さ指定子 l が使用されていない場合、変換指定子 c、s、および [ は、最初の文字が変換される前にゼロに初期化された std::mbstate_t オブジェクトを使用して std::wcrtomb を呼び出すかのように、ワイドからマルチバイト文字への変換を実行します。 変換指定子 s および [ は、一致した文字に加えて常にnull終端文字を格納します。宛先配列のサイズは、指定されたフィールド幅より少なくとも1つ大きい必要があります。 %s または %[ を、宛先配列のサイズを指定せずに使用することは、std::gets と同様に危険です。 固定幅整数型（std::int8_t など）の正しい変換指定子は、ヘッダー <cinttypes> で定義されています（ただし、SCNdMAX、SCNuMAX などは %jd、%ju などと同義です）。 各変換指定子の処理後にはシーケンスポイントが存在します。これにより、複数のフィールドを同じ「シンク」変数に格納することが可能になります。 指数部分に数字がない不完全な浮動小数点値を解析する際（例: 変換指定子 %f で "100er" を解析する）、「100e」（有効な浮動小数点数の可能性のあるプレフィックス）が消費され、マッチングエラー（消費されたシーケンスを浮動小数点数に変換できない）が発生し、「r」が残ります。一部の実装ではこの規則に従わず、「100」のみを消費するようにロールバックし、「er」を残す場合があります（例: glibcバグ1765）。 変換指定子が不正な場合、動作は未定義です。

戻り値

正常に読み取られた引数の数、または最初の受信引数が代入される前にエラーが発生した場合は EOF。

関連項目

vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	stdin、ファイルストリームから書式付きワイド文字入力を読み込む または可変長引数リストを使用してバッファから (関数)
Cドキュメント (wscanf、fwscanf、swscanf)