std:: vwscanf, std:: vfwscanf, std:: vswscanf
|
定義先ヘッダ
<cwchar>
|
||
|
int
vwscanf
(
const
wchar_t
*
format, std
::
va_list
vlist
)
;
|
(1) | (C++11以降) |
|
int
vfwscanf
(
std::
FILE
*
stream,
const
wchar_t
*
format, std
::
va_list
vlist
)
;
|
(2) | (C++11以降) |
|
int
vswscanf
(
const
wchar_t
*
buffer,
const
wchar_t
*
format, std
::
va_list
vlist
)
;
|
(3) | (C++11以降) |
多様なソースからデータを読み取り、 format に従って解釈し、結果を vlist で定義された場所に格納します。
目次 |
パラメータ
| stream | - | 読み取り元の入力ファイルストリーム |
| buffer | - | 読み取り元のヌル終端ワイド文字列へのポインタ |
| format | - | 入力読み取り方法を指定するヌル終端ワイド文字列へのポインタ |
| vlist | - | 受信引数を含む可変引数リスト |
format
文字列は以下で構成されます
- 空白文字以外のワイド文字( % を除く):書式文字列内の各文字は、入力ストリームから正確に同一の文字1文字を消費する。ストリーム上の次の文字が等しくない場合、関数は失敗する。
- 空白文字:書式文字列内の単一の空白文字は、入力から利用可能な連続する全ての空白文字を消費する(ループ内で std::iswspace を呼び出して判定される)。 " \n " 、 " " 、 " \t \t " など、書式文字列内の空白文字に違いはないことに注意。
- 変換指定。各変換指定は以下の形式を持つ:
-
- 導入 % 文字。
-
- (オプション) 代入抑制文字 * 。このオプションが存在する場合、関数は変換結果を受信引数に代入しません。
-
- (オプション) ゼロより大きい整数値で、 最大フィールド幅 を指定します。これは現在の変換指定子によって指定された変換を行う際に関数が消費できる最大文字数を示します。 % 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
|
1文字または文字のシーケンスにマッチします。
|
N/A | N/A |
char
*
|
wchar_t
*
|
N/A | N/A | N/A | N/A | N/A |
s
|
空白以外の文字の連続( 文字列 )にマッチします。
|
|||||||||
[
set
]
|
set 内の文字からなる空でない文字シーケンスにマッチします。
|
|||||||||
d
|
10進整数 にマッチします。
|
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
*
|
該当なし | ||
i
|
整数 にマッチします。
|
|||||||||
u
|
符号なし 10進整数 にマッチします。
|
|||||||||
o
|
符号なし 8進整数 にマッチします。
|
|||||||||
x
X
|
符号なし 16進整数 にマッチします。
|
|||||||||
n
|
これまでに読み取られた 文字数を返します 。
|
|||||||||
a
(C++11)
A
(C++11)
e
E
f
F
(C++11)
g
G
|
浮動小数点数 にマッチします。
|
該当なし | 該当なし |
float
*
|
double
*
|
該当なし | 該当なし | 該当なし | 該当なし |
long
double
*
|
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 と [ は、常に一致した文字に加えてナルターミネータを格納します。変換先配列のサイズは、指定されたフィールド幅より少なくとも1大きくなければなりません。変換先配列のサイズを指定せずに % s または % [ を使用することは、 std::gets と同じくらい安全ではありません。 固定幅整数型 ( std::int8_t など)に対する正しい変換指定はヘッダ <cinttypes> で定義されています(ただし SCNdMAX 、 SCNuMAX などは % jd 、 % ju などと同義です)。 各変換指定子の動作の後に シーケンスポイント が存在します。これにより、複数のフィールドを同じ「シンク」変数に格納することが可能になります。 指数部で終わり数字がない不完全な浮動小数点値(例えば変換指定子 % f で "100er" を解析する場合)を解析するとき、シーケンス "100e" (有効な浮動小数点数の可能性のある最長の接頭辞)が消費され、マッチングエラー(消費されたシーケンスを浮動小数点数に変換できない)が発生し、 "r" が残ります。既存の実装の中にはこの規則に従わず、 "100" のみを消費するようにロールバックし、 "er" を残すものもあります(例: glibc bug 1765 )。 変換指定が無効な場合、動作は未定義です。 |
||||||||||
戻り値
正常に読み取られた引数の数、または EOF エラーが発生した場合。
例
|
このセクションは不完全です
理由: 例がありません |
関連項目
|
標準入力、ファイルストリーム、またはバッファから
書式化されたワイド文字入力を読み込む
(関数) |
|
|
Cドキュメント
for
vwscanf
,
vfwscanf
,
vswscanf
|
|