getchar, getwchar

Articolo
06/09/2015

Legge un carattere dallo standard input.

int getchar();
wint_t getwchar();

Valore restituito

Restituisce il carattere letto. Per indicare un errore di lettura o uno stato di fine file, getchar returns EOF, e getwchar ritorna WEOF. Per getchar, utilizzare ferror o feof per controllare la presenza di un errore o di uno stato di fine file.

Note

Ogni routine legge un singolo carattere da stdin e incrementa il puntatore del file associato in modo tale che punti al carattere successivo. getchar svolge lo stesso ruolo di _fgetchar, ma è implementata come funzione e come macro.

Queste funzioni bloccano il thread chiamante e sono pertanto thread-safe. Per una versione non bloccante, vedere _getchar_nolock, _getwchar_nolock.

Mapping di routine su testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_gettchar	getchar	getchar	getwchar

Requisiti

Routine	Intestazione obbligatoria
getchar	<stdio.h>
getwchar	<stdio.h> o <wchar.h>

La console non è supportata nelle applicazioni Windows Store. Gli handle del flusso standard associati alla console,stdin, stdout e stderr, devono essere reindirizzati prima di poter utilizzare le funzioni di runtime del linguaggio C nelle applicazioni Windows Store. Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

// 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);
}