fgets, fgetws

아티클
04/10/2013

문자열을에서 스트림을 가져옵니다.

char *fgets( 
   char *str,
   int n,
   FILE *stream 
);
wchar_t *fgetws( 
   wchar_t *str,
   int n,
   FILE *stream 
);

매개 변수

str
데이터에 대 한 저장소 위치입니다.
n
최대 문자 수를 읽을 수 있습니다.
stream
포인터를 FILE 구조체입니다.

반환 값

이러한 각 기능을 반환 str.NULL또는 오류가 파일 끝 조건을 나타내기 위해 반환 됩니다.사용 feof 또는 ferror 에서 오류가 발생 했는지 여부를 확인 합니다.경우 str 또는 stream 은 null 포인터입니다. 또는 n 보다 작거나 것의 설명에 따라이 함수는 잘못 된 매개 변수 처리기 0 이면를 호출 매개 변수 유효성 검사.실행을 계속 수 있으면 errno 으로 설정 EINVAL 함수를 반환 하 고 NULL.

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

설명

fgets 함수에서 입력 문자열로 읽어 stream 인수에 저장 str.fgets문자를 읽고 스트림의 현재 위치를 및 끝 문자를 읽을 때까지 나는 스트림의 첫 번째 줄 바꿈 문자를 포함 하 여 것을 n -1에서 처음.저장 된 결과 str null 문자로 추가 됩니다.경우는 줄 바꿈 문자 읽기, 문자열에 포함 되어 있습니다.

fgetws와이드 문자 버전입니다 fgets.

fgetws와이드 문자 인수를 읽고 str 멀티 바이트 문자 문자열 또는 와이드 문자 문자열 여부에 따라 stream 각각 텍스트 모드 또는 이진 모드에서 열립니다.텍스트 및 이진 모드에서 유니코드와 멀티 바이트 스트림-I/O를 사용 하는 방법에 대 한 자세한 내용은 참조 하십시오. 텍스트 및 이진 모드 파일 I/O 및 유니코드 스트림 I/O 텍스트 및 이진 모드에서.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_fgetts	fgets	fgets	fgetws

요구 사항

Function	필수 헤더
fgets	<stdio.h>
fgetws	<stdio.h> 또는 <wchar.h>

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

예제

// crt_fgets.c
// This program uses fgets to display
// a line from a file on the screen.
//

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char line[100];

   if( fopen_s( &stream, "crt_fgets.txt", "r" ) == 0 )
   {
      if( fgets( line, 100, stream ) == NULL)
         printf( "fgets error\n" );
      else
         printf( "%s", line);
      fclose( stream );
   }
}