getc, getwc

Articolo
06/09/2015

Leggere un carattere da un flusso.

int getc( 
   FILE *stream 
);
wint_t getwc( 
   FILE *stream 
);

Parametri

stream
Flusso di input.

Valore restituito

Restituisce il carattere letto. Per indicare un errore di lettura o uno stato di fine file, getc ritorna EOF, e getwc ritorna WEOF. Per getc, utilizzare ferror o feof per controllare la presenza di un errore o di uno stato di fine file. Se stream è NULL, getc e getwc invocano il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono EOF (o WEOF pergetwc) e impostano errno a EINVAL.

Vedere _doserrno, errno, _sys_errlist, e _sys_nerr per ulteriori informazioni su questi, e altri, codici di errore.

Note

Ogni routine legge un singolo carattere da un file alla posizione corrente e incrementa il puntatore del file associato (se definito) per indicare il carattere successivo. Il file è associato all'oggetto stream.

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

I commenti di routine specifiche seguenti.

Routine	Osservazioni
getc	Equivale a fgetc, ma implementato come funzione e come macro.
getwc	Versione a caratteri estesi di getc. Legge un carattere multibyte o un caratteri estesi in base a se stream viene aperto in modalità testo o in modalità binaria.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_gettc	getc	getc	getwc

Requisiti

Routine	Intestazione obbligatoria
getc	<stdio.h>
getwc	<stdio.h> o <wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.

Esempio

// crt_getc.c
// Use getc to read a line from a file.

#include <stdio.h>

int main()
{
    char buffer[81];
    int i, ch;
    FILE* fp;
    
    // Read a single line from the file "crt_getc.txt". 

    fopen_s(&fp, "crt_getc.txt", "r");
    if (!fp)
    {
       printf("Failed to open file crt_getc.txt.\n");
       exit(1);
    }

    for (i = 0; (i < 80) && ((ch = getc(fp)) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }
       
    // Terminate string with a null character 
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);

    fclose(fp);
}