getchar, getwchar

Membaca karakter dari input standar.

Sintaks

int getchar();
wint_t getwchar();

Nilai hasil

Mengembalikan karakter yang dibaca. Fungsi-fungsi ini menunggu input dan tidak kembali hingga input tersedia.

Untuk menunjukkan kesalahan baca atau kondisi akhir file, getchar mengembalikan EOF, dan getwchar mengembalikan WEOF. Untuk getchar, gunakan ferror atau feof untuk memeriksa kesalahan atau untuk akhir file.

Keterangan

Setiap rutinitas membaca satu karakter dari stdin dan menaikkan penunjuk file terkait untuk menunjuk ke karakter berikutnya. getchar sama dengan _fgetchar, tetapi diimplementasikan sebagai fungsi dan sebagai makro.

Fungsi-fungsi ini juga mengunci utas panggilan dan aman untuk utas. Untuk versi non-penguncian, lihat _getchar_nolock, _getwchar_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
_gettchar	getchar	getchar	getwchar

Persyaratan

Rutin	Header yang diperlukan
getchar	<stdio.h>
getwchar	<stdio.h> atau <wchar.h>

Konsol tidak didukung di aplikasi Platform Windows Universal (UWP). Handel aliran standar yang terkait dengan konsol, , stdin, stdoutdan stderr, harus dialihkan sebelum fungsi run-time C dapat menggunakannya di aplikasi UWP. Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

// crt_getchar.c
// Use getchar to read a line from stdin.

#include <stdio.h>

int main()
{
    char buffer[81];
    int i, ch;

    for (i = 0; (i < 80) && ((ch = getchar()) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }

    // Terminate string with a null character
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);
}

This textInput was: This text

Baca juga

Streaming I/O
getc, getwc
fgetc, fgetwc
_getch, _getwch
putc, putwc
ungetc, ungetwc