fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l

아티클
02/21/2013

읽기는 스트림의 데이터를에서 포맷합니다.이러한 버전의 있습니다 fscanf, _fscanf_l, fwscanf, _fwscanf_l 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.

int fscanf_s( 
   FILE *stream,
   const char *format [,
   argument ]... 
);
int _fscanf_s_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]... 
);
int fwscanf_s( 
   FILE *stream,
   const wchar_t *format [,
   argument ]... 
);
int _fwscanf_s_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]... 
);

매개 변수

stream
포인터를 FILE 구조체입니다.
format
컨트롤 서식 문자열입니다.
argument
선택적 인수입니다.
locale
사용 하는 로캘.

반환 값

각이 함수를 성공적으로 변환 하 고 지정 된 필드 수를 반환 합니다. 반환 값이 지정 되었지만 읽을 필드는 포함 되지 않습니다.반환 값이 0 이면 필드가 없는 할당 된 나타냅니다.오류가 발생 한 경우 첫 번째 변환 전에 파일 스트림의 끝에 도달 하면 반환 값입니다 EOF 에 대 한 fscanf_s 및 fwscanf_s.

이러한 함수 매개 변수의 유효성을 검사 합니다.Ian이 nvalid 파일 포인터를 스트림의 경우 또는 format 는 null 포인터에 설명 된 대로 이러한 함수가 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사.다음이 함수 실행 계속할 수 있는지 여부를 반환 EOF 를 설정 하 고 errno 에 EINVAL.

설명

fscanf_s 함수를 현재 위치에서 데이터를 읽고 stream 에 의해 주어진 위치 argument (있는 경우).각 argument 변수를 형식 지정자에 해당 하는 형식에 대 한 포인터 이어야 합니다 format.format해석 하는 입력 필드와 같은 가진 컨트롤 형성 하 고 작동 하는 format 인수에 대 한 scanf_s. 참조 하십시오 형식 사양을 필드 – scanf 함수 및 함수 wscanf 에 대 한 설명에 대 한 format*.*fwscanf_s 의 와이드 문자 버전입니다 fscanf_s. 형식 인수를 fwscanf_s 와이드 문자 문자열입니다.스트림에서 ANSI 모드에서 열려 있는 경우 이러한 함수를 동일 하 게 동작 합니다.fscanf_s현재 입력 스트림에서 유니코드를 지원 하지 않습니다.

안전한 함수 간의 주요 차이점 (와 _s 접미사) 이전 함수는 보안 기능 각각의 글자 크기를 필요로 하 고 c, C, s, S 및 [ 종류 필드는 변수 바로 다음 인수로 전달 될 수 있습니다.자세한 내용은 scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l 및 scanf 폭 사양을 참조하십시오.

[!참고]

크기 매개 변수의 형식이 unsigned, 않습니다 size_t.

버전으로 이러한 함수는 _l 접미사는 현재 스레드의 로캘 대신 전달 된 로캘 매개 변수를 사용할 경우를 제외 하 고 동일 합니다.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_ftscanf_s	fscanf_s	fscanf_s	fwscanf_s
_ftscanf_s_l	_fscanf_s_l	_fscanf_s_l	_fwscanf_s_l

요구 사항

Function	필수 헤더
fscanf_s, _fscanf_s_l	<stdio.h>
fwscanf_s, _fwscanf_s_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_fscanf_s.c
// This program writes formatted
// data to a file. It then uses fscanf to
// read the various data back from the file.
 
#include <stdio.h>
#include <stdlib.h>

FILE *stream;

int main( void )
{
   long l;
   float fp;
   char s[81];
   char c;

   errno_t err = fopen_s( &stream, "fscanf.out", "w+" );
   if( err )
      printf_s( "The file fscanf.out was not opened\n" );
   else
   {
      fprintf_s( stream, "%s %ld %f%c", "a-string", 
               65000, 3.14159, 'x' );
      // Set pointer to beginning of file:
      fseek( stream, 0L, SEEK_SET );

      // Read data back from file:
      fscanf_s( stream, "%s", s, _countof(s) );
      fscanf_s( stream, "%ld", &l );

      fscanf_s( stream, "%f", &fp );
      fscanf_s( stream, "%c", &c, 1 );

      // Output data read:
      printf( "%s\n", s );
      printf( "%ld\n", l );
      printf( "%f\n", fp );
      printf( "%c\n", c );

      fclose( stream );
   }
}