_getche, _getwche

Pobiera znak z konsoli z echo.

Ważne

Tego interfejsu API nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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

Wartość zwracana

Zwraca odczyt znaku. Nie ma zwracanego błędu.

Uwagi

Funkcje _getche i _getwche odczytują pojedynczy znak z konsoli z echo, co oznacza, że znak jest wyświetlany w konsoli programu . Żadna z tych funkcji nie może służyć do odczytywania kombinacji klawiszy CTRL+C. Gdy _getche lub _getwche odczytuje klawisz funkcji lub klawisz strzałki, funkcja musi być wywoływana dwukrotnie; pierwsze wywołanie zwraca wartość 0 lub 0xE0, a drugie wywołanie zwraca rzeczywisty kod klucza.

Te funkcje blokują wątek wywołujący i dlatego są bezpieczne wątkowo. Aby uzyskać informacje o wersjach nieblokujących, zobacz _getche_nolock, _getwche_nolock.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_gettche	_getche	_getche	_getwche

Wymagania

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

Aby uzyskać więcej informacji o 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
}

abcdefy

Type 'Y' when finished typing keys: abcdefyY

Zobacz też

We/Wy konsoli i portu
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock