_getche
, _getwche
Konsoldan yankılı bir karakter alır.
Önemli
Bu API, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.
Sözdizimi
int _getche( void );
wint_t _getwche( void );
Dönüş değeri
Okunan karakteri döndürür. Hata döndürme yok.
Açıklamalar
_getche
ve _getwche
işlevleri konsolundan tek bir karakteri yankıyla okur, yani karakter konsolda görüntülenir. Bu işlevlerin hiçbiri CTRL+C tuşlarını okumak için kullanılamaz. İşlev tuşunu veya ok tuşunu okuduğunda _getche
veya _getwche
okuduğunda, işlev iki kez çağrılmalıdır; ilk çağrı 0 veya 0xE0 döndürür ve ikinci çağrı gerçek anahtar kodunu döndürür.
Bu işlevler çağıran iş parçacığını kilitler ve bu nedenle iş parçacığı güvenlidir. Kilitlenmeyen sürümler için bkz _getche_nolock
. , _getwche_nolock
.
Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.
Genel metin yordamı eşlemeleri
Tchar.h yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_gettche |
_getche |
_getche |
_getwche |
Gereksinimler
Yordam | Gerekli başlık |
---|---|
_getche |
<conio.h> |
_getwche |
<conio.h> veya <wchar.h> |
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Örnek
// crt_getche.c
// compile with: /c
// This program reads characters from
// the keyboard until it receives a 'Y' or 'y'.
#include <conio.h>
#include <ctype.h>
int main( void )
{
int ch;
_cputs( "Type 'Y' when finished typing keys: " );
do
{
ch = _getche();
ch = toupper( ch );
} while( ch != 'Y' );
_putch( ch );
_putch( '\r' ); // Carriage return
_putch( '\n' ); // Line feed
}
abcdefy
Type 'Y' when finished typing keys: abcdefyY
Ayrıca bkz.
Konsol ve bağlantı noktası G/Ç
_cgets
, _cgetws
getc
, getwc
_ungetch
, _ungetwch
, _ungetch_nolock
, _ungetwch_nolock