_ungetch、_ungetwch、_ungetch_nolock、_ungetwch_nolock
更新 : 2007 年 11 月
コンソールから読み取った最後の文字を戻します。
int _ungetch(
int c
);
wint_t _ungetwch(
wint_t c
);
int _ungetch_nolock(
int c
);
wint_t _ungetwch_nolock(
wint_t c
);
パラメータ
- c
戻す文字。
戻り値
どちらの関数も、正常に終了すると文字 c を返します。エラーが発生した場合、_ungetch 関数は値 EOF を返し、_ungetwch 関数は WEOF を返します。
解説
これらの関数は、文字 c をコンソールに戻し、c が _getch または _getche (_getwch または _getwche) によって次に読み取られる文字になるようにします。_ungetch と _ungetwch は、次の読み取りまでに 2 回以上呼び出されると失敗します。引数 c に EOF (または WEOF) は指定できません。
_nolock サフィックスが付けられたバージョンは、他のスレッドからの干渉から保護されない点を除いて同じです。スレッドをロックアウトするオーバーヘッドがないので、この方が処理が早くなります。これらの関数は、シングルスレッド アプリケーションや、呼び出し元のスコープで既にスレッドの隔離が処理されている場合などの、スレッド セーフなコンテキストだけで使用します。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_ungettch |
_ungetch |
_ungetch |
_ungetwch |
_ungettch_nolock |
_ungetch_nolock |
_ungetch_nolock |
_ungetwch_nolock |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_ungetch, _ungetch_nolock |
<conio.h> |
_ungetwch, _ungetwch_nolock |
<conio.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_ungetch.c
// compile with: /c
// In this program, a white-space delimited
// token is read from the keyboard. When the program
// encounters a delimiter, it uses _ungetch to replace
// the character in the keyboard buffer.
//
#include <conio.h>
#include <ctype.h>
#include <stdio.h>
int main( void )
{
char buffer[100];
int count = 0;
int ch;
ch = _getche();
while( isspace( ch ) ) // Skip preceding white space.
ch = _getche();
while( count < 99 ) // Gather token.
{
if( isspace( ch ) ) // End of token.
break;
buffer[count++] = (char)ch;
ch = _getche();
}
_ungetch( ch ); // Put back delimiter.
buffer[count] = '\0'; // Null terminate the token.
printf( "\ntoken = %s\n", buffer );
}
White
token = White