_getch, _getwch

Mendapatkan karakter dari konsol tanpa gema.

Penting

API ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

int _getch( void );
wint_t _getwch( void );

Nilai hasil

Mengembalikan karakter yang dibaca. Tidak ada pengembalian kesalahan.

Keterangan

Fungsi _getch dan _getwch membaca satu karakter dari konsol tanpa menggemakan karakter. Untuk membaca kunci fungsi atau tombol panah, setiap fungsi harus dipanggil dua kali. Panggilan pertama mengembalikan 0 atau 0xE0. Panggilan kedua mengembalikan kode pemindaian kunci.

Fungsi-fungsi ini mengunci utas panggilan dan begitu juga utas aman. Untuk versi non-penguncian, lihat _getch_nolock, _getwch_nolock.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

Tchar.h Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_gettch	_getch	_getch	_getwch

Persyaratan

Rutin	Header yang diperlukan
_getch	<conio.h>
_getwch	<conio.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

// crt_getch.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 = _getch();
      ch = toupper( ch );
   } while( ch != 'Y' );

   _putch( ch );
   _putch( '\r' );    // Carriage return
   _putch( '\n' );    // Line feed
}

abcdefy

Type 'Y' when finished typing keys: Y

Baca juga

I/O konsol dan port
_getche, _getwche
_cgets, _cgetws
getc, getwc
_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock