getc getwc

Článek
03/04/2013

Znak čtení z datového proudu.

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

Parametry

stream
Vstupní proud.

Vrácená hodnota

Vrátí znak číst.K označení konce souboru podmínku nebo Chyba čtení getc vrátí EOF, a getwc vrátí WEOF.Pro getc, použijte ferror nebo feof kontrola chybu nebo konec souboru.Pokud stream je NULL, getc a getwc vyvolat popisovač neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, vrátí tyto funkce EOF (nebo WEOF progetwc) a errno na EINVAL.

Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných kódů chyb.

Poznámky

Každá rutina načte znak ze souboru na aktuální pozici a přírůstky ukazatel přidružený soubor (Pokud je definována) přejděte na další znak.Je soubor spojen s stream.

Tyto funkce uzamčení volající vlákno a proto jsou podprocesu.Verze zamykání, viz _getc_nolock _getwc_nolock.

Postupujte podle rutiny konkrétní poznámky.

Rutina	Poznámky
getc	Stejné jako fgetc, ale implementované jako funkce a makra.
getwc	Verze znaku Wide getc.Přečte vícebajtové znaky nebo širokými znaky podle zda stream je otevřen v režimu text nebo binary.

Obecný Text rutinní mapování

TCHAR.Rutina H	_UNICODE & _MBCS není definován	_MBCS, definice	_UNICODE, definice
_gettc	getc	getc	getwc

Požadavky

Rutina	Požadované záhlaví
getc	<stdio.h>
getwc	<stdio.h> nebo <wchar.h>

Další informace o kompatibilitě, viz Compatibility v úvodu.

Příklad

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