GETC(3)

명칭
fgetc, getc, getchar, getw - 입력 스트림로부터 다음의 캐릭터 또는 워드를 취득

프로그램 라이브러리
libc

서식
<stdio.h> int fgetc(FILE *stream) int getc(FILE *stream) int getchar() int getw(FILE *stream)

해설
fgetc() 함수는, stream 그리고 가리킨 스트림로부터, (존재하고 있는 경우) 다음의 입력 캐릭터를 취득하는지, 또는, ungetc(3) 에 의해 그 스트림에 이륙 시각의 연기 된, 다음의 캐릭터를 취득합니다.

getc() 함수는 fgetc() (와)과 기본적으로 같은 기능입니다만, 이것은 인 라인으로 전개하는 매크로입니다.

getchar() 함수는, 인수 stdin 가 붙어 있다 getc() (와)과 동등합니다.

getw() 함수는 stream 그리고 가리킨 스트림로부터, 다음의 int (을)를 (존재하고 있는 경우) 취득합니다.

반환값
처리가 정상적으로 완료했을 경우, 이러한 routine는 모두 stream (으)로부터 다음의 요구 오브젝트를 돌려줍니다. 스트림이 파일의 마지막에 이르렀는지, 또는 독포함 에러가 발생했을 경우는 EOF (을)를 돌려줍니다. 파일의 마지막인가, 에러인가를 식별하려면 , feof(3) (와)과 ferror(3) routine를 사용할 필요가 있습니다. 에러가 발생했을 경우는, 글로벌 변수 errno 에 에러를 나타내는 값이 설정됩니다. 파일의 종단을 나타내는 상태는 단말이어도 그대로 남아, 그 후의 읽기에 대해서는 clearerr(3) 에 의해 상태가 클리어 되지 않으면 EOF (을)를 돌려주게 됩니다.

관련 항목
ferror(3), fopen(3), fread(3), putc(3), ungetc(3)

표준
fgetc(), getc() 및 getchar() 함수는, isoC 에 적합하고 있습니다.

버그
EOF (은)는, 유효한 정수치이므로 getw() (을)를 호출한 후의 에러를 체크하려면 , feof(3) 및 ferror(3) (을)를 사용할 필요가 있습니다. int 의 사이즈와 바이트순서는 머신에 의해 다양합니다. 이식 가능한 어플리케이션이 목적이라면, getw() 의 사용은 추천 할 수 없습니다.