Condividi tramite

getc, getwc

  • Articolo

Legge un carattere dal flusso.

Sintassi

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

Parametri

stream
Flusso di input.

Valore restituito

Restituisce il carattere letto. Per indicare una condizione di errore di lettura o di fine file, getc restituisce EOF e getwc restituisce WEOF. Per getc, usare ferror o feof per controllare se è presente un errore o se viene raggiunta la fine del file. Se stream è NULLgetc e getwc richiamare il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono EOF (o WEOF per getwc) e impostano su errno EINVAL.

Per altre informazioni sui codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

Ogni routine legge un singolo carattere da un file alla posizione corrente e incrementa il puntatore del file associato (se definito) per puntare al carattere successivo. Il file è associato a stream.

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

Seguono note specifiche per le routine.

Ciclo Osservazioni:
getc Equivale a fgetc, ma implementato come funzione e come macro.
getwc Versione a caratteri wide di getc. Legge un carattere multibyte o un carattere wide a seconda che stream venga aperto in modalità testo o in modalità binaria.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine TCHAR.H _UNICODE e _MBCS non definito _MBCS definito _UNICODE definito
_gettc getc getc getwc

Requisiti

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

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

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

Input: crt_getc.txt

Line one.
Line two.

Output

Input was: Line one.

Vedi anche

I/O di flusso
fgetc, fgetwc
_getch, _getwch
putc, putwc
ungetc, ungetwc