_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
// 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