getc, getwc

아티클
02/21/2013

문자 스트림을 읽습니다.

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

매개 변수

stream
입력된 스트림입니다.

반환 값

읽을 문자를 반환 합니다.읽기 오류 또는 파일 끝 조건을 나타내기 위해 getc 반환 EOF, 및 getwc 반환 WEOF.에 대 한 getc를 사용 하 여 ferror 또는 feof 오류 또는 파일의 끝을 확인 합니다.경우 stream 입니다 NULL, getc 및 getwc 의 설명에 따라 잘못 된 매개 변수 처리기를 호출 합니다. 매개 변수 유효성 검사.다음이 함수 실행 계속할 수 있는지 여부를 반환 EOF (또는 WEOF 에 대 한getwc)를 설정 하 고 errno 에 EINVAL.

참조 하십시오 _doserrno, errno, _sys_errlist, 및 _sys_nerr 이 및 기타 오류 코드에 대 한 자세한 내용은.

설명

각 루틴 단일 문자 파일을 현재 위치와 증가 관련된 파일 포인터 (정의 된 경우)에 다음 문자를 읽습니다.해당 파일에 연결 된 stream.

이러한 함수 호출 하는 스레드를 잠그고 그러므로 스레드로부터 안전 하지.비잠금 버전을 참조 하십시오. _getc_nolock, _getwc_nolock.

루틴이 관련 설명을 따릅니다.

루틴	설명
getc	다른 이름으로 동일한 fgetc, 하지만 구현 된 함수 및 매크로로.
getwc	와이드 문자 버전을 getc.여부에 따라 와이드 문자 또는 멀티 바이트 문자를 읽고 stream 텍스트 모드 또는 이진 모드에서 열립니다.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_gettc	getc	getc	getwc

요구 사항

루틴	필수 헤더
getc	<stdio.h>
getwc	<stdio.h> 또는 <wchar.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

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