_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
Lihat juga
I/O konsol dan port
_cgets
, _cgetws
getc
, getwc
_ungetch
, , _ungetwch
_ungetch_nolock
,_ungetwch_nolock