_getche, _getwche

Mendapatkan karakter dari konsol dengan echo.

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 _getche( void );
wint_t _getwche( void );

Nilai hasil

Mengembalikan karakter yang dibaca. Tidak ada pengembalian kesalahan.

Keterangan

Fungsi _getche dan _getwche membaca satu karakter dari konsol dengan echo, yang berarti bahwa karakter ditampilkan di konsol. Tidak ada fungsi ini yang dapat digunakan untuk membaca CTRL+C. Saat _getche atau _getwche membaca kunci fungsi atau tombol panah, fungsi harus dipanggil dua kali; panggilan pertama mengembalikan 0 atau 0xE0, dan panggilan kedua mengembalikan kode kunci yang sebenarnya.

Fungsi-fungsi ini mengunci utas panggilan dan oleh karena itu aman utas. Untuk versi non-penguncian, lihat _getche_nolock, _getwche_nolock.

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

Pemetaan rutin teks generik

Rutinitas Tchar.h	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_gettche	_getche	_getche	_getwche

Persyaratan

Rutin	Header yang diperlukan
_getche	<conio.h>
_getwche	<conio.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

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

Baca juga

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