_getche, _getwche

Artykuł
06/09/2015

Pobiera znak z konsoli z echem.

Ważne
Tego API nie można używać w aplikacjach korzystających ze środowiska wykonawczego Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /ZW.

int _getche( void );
wint_t _getwche( void );

Wartość zwracana

Zwraca odczyt znaku.Nie będzie zwrotu błędu.

Uwagi

_getche i _getwche funkcje odczytują pojedynczy znak z tej konsoli, echo, co oznacza, że znak jest wyświetlany na konsoli.Żadnej z tych funkcji nie można użyć do odczytu klawiszy CTRL + C.Podczas czytania klawisza funkcyjnego lub klawisza strzałki, każda funkcja musi być wywołana dwukrotnie; pierwsza zwraca wywołanie 0 lub wartość 0xE0, a druga zwraca wywołanie rzeczywistego klucza kodu.

Te funkcje blokują wywołania wątku i dlatego są odporne na wątki.Aby uzyskać informacje na temat wersji bez blokady, zobacz _getche_nolock, _getwche_nolock.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE i _MBCS nie zdefiniowany	_MBCS zdefiniowano	_UNICODE zdefiniowany
_getche	_getche	_getch	_getwche

Wymagania

Procedura	Wymagany nagłówek
_getche	<conio.h>
_getwche	<conio.h> lub <wchar.h>

Aby uzyskać więcej informacji na temat zgodności – zobacz: Zgodność.

Przykład

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