名前空間
変種
操作

ungetwc

提供: cppreference.com
< c‎ | io
 
 
ファイル入出力
関数
ファイルアクセス
直接入出力
書式なし入出力
(C11以前)(C11およびそれ以降)
(C95)(C95)
(C95)
(C95)(C95)
(C95)
ungetwc
(C95)
書式付き入力
書式付き出力
ファイル位置操作
エラー処理
ファイルに対する操作
 
ヘッダ <wchar.h> で定義
wint_t ungetwc( wint_t ch, FILE *stream );
(C95およびそれ以降)

chWEOF と等しくなければ、ワイド文字 ch を、 stream からの後続の読み込み操作がそのワイド文字を受け取るように、ストリーム stream に紐付けられている入力バッファにプッシュします。 ストリームに紐付けられている外部デバイスは変更されません。

ストリームの位置を再設定する操作 fseekfsetpos および rewindungetwcの効果を破棄します。

読み込みまたは位置の再設定を挟まずに ungetwc が2回以上呼ばれた場合、 ungetwc は失敗するかもしれません (別の言い方をすると、サイズ1のプッシュバックバッファは保証されていますが、それより大きいバッファは処理系定義です)。 複数回の ungetwc に成功した場合、読み込み操作はプッシュバックされたワイド文字を ungetwc の逆順で取得します。

chWEOF と等しい場合、操作は失敗し、ストリームは影響を受けません。

ungetwc の呼び出しの成功は、ファイル終端状態フラグ feof をクリアします。

ストリーム (テキストかバイナリかにかかわらず) に対する ungetwc の呼び出しの成功は、ストリームの位置指示子を未規定の方法で変更しますが、プッシュバックされたワイド文字を読み込み操作ですべて取得した後、ストリームの位置指示子が ungetwc 前の値と等しくなることは保証されます。

目次

[編集] 引数

ch - 戻されるワイド文字
stream - ワイド文字を戻すファイルストリーム

[編集] 戻り値

成功した場合は ch が返されます。

失敗した場合は WEOF が返されます。 指定されたストリームは変更されません。

[編集] 参考文献

  • C11 standard (ISO/IEC 9899:2011):
  • 7.29.3.10 The ungetwc function (p: 425-426)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.24.3.10 The ungetwc function (p: 370-371)

[編集] 関連項目

ファイルストリームに文字を戻します
(関数) [edit]
ファイルストリームからワイド文字を取得します
(関数) [edit]