fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

아티클
06/09/2015

형식이 지정된 데이터를 스트림에 출력합니다. CRT의 보안 기능에 설명된 대로 보안 향상 기능이 포함된 fprintf, _fprintf_l, fwprintf, _fwprintf_l 버전입니다.

int fprintf_s( 
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_s_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int fwprintf_s( 
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_s_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]…
);

매개 변수

stream
FILE 구조체에 대한 포인터입니다.
format
형식 컨트롤 문자열입니다.
argument
선택적 인수입니다.
locale
사용할 로캘입니다.

반환 값

fprintf_s는 쓴 바이트 수를 반환합니다. fwprintf_s는 작성 된 와이드 문자의 수를 반환 합니다. 이러한 각 함수는 출력 오류가 발생했을 때 대신 음수 값을 반환합니다.

설명

fprintf_s 는 서식을 지정하고 일련의 문자와 값을 출력stream*.* 에 를 출력합니다. 각 함수 argument (있는 경우) 는 format*.* 의 해당 형식 사양에 따라 변환되고 출력됩니다. fprintf_s에 대해서, format 인수는 printf_s와 동일한 구문을 사용합니다.

fwprintf_s는 fprintf_s의 와이드 문자 버전이며, fwprintf_s, format은 와이드 문자 문자열입니다. 이러한 함수는 ANSI 모드에서 스트림이 열린 경우 동일하게 동작합니다. fprintf_s 는 현재 UNICODE 스트림에 대한 출력을 지원하지 않습니다.

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

보안 정보
format이 사용자 정의 문자열이 아닌지 확인하십시오.

보안이 없는 버전 같은 (fprintf, _fprintf_l, fwprintf, _fwprintf_l 를 참조하세요) 이러함 함수는 매개 변수의 유효성을 조사하고 매개 변수 유효성 검사 에 설명 된 대로 잘못된 매개 변수 처리기를 호출합니다.stream 또는 format 가 null 포인터인 경우에도 마찬가지 입니다. 형식 문자열 자체는 또한 유효성을 검사 한다는 점에서 안전하지 않은 버전의 이러한 함수입니다. 알 수 없거나 잘못된 형식의 형식 지정자를 이러한 함수는 잘못된 매개 변수 예외를 생성합니다. 모든 종류에서, 계속해서 실행하도록 허용된 경우, 이 함수는 -1 를 반환하고 errno 를 EINVAL로 설정합니다. 이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr을 참조하십시오.

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_ftprintf_s	fprintf_s	fprintf_s	fwprintf_s
_ftprintf_s_l	_fprintf_s_l	_fprintf_s_l	_fwprintf_s_l

자세한 내용은 형식 사양을 참조하십시오.

요구 사항

Function	필수 헤더
fprintf_s, _fprintf_s_l	<stdio.h>
fwprintf_s, _fwprintf_s_l	<stdio.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 소개 단원의 호환성 부분을 참조하십시오.

예제

// crt_fprintf_s.c
// This program uses fprintf_s to format various
// data and print it to the file named FPRINTF_S.OUT. It
// then displays FPRINTF_S.OUT on the screen using the system
// function to invoke the operating-system TYPE command.
 
#include <stdio.h>
#include <process.h>

FILE *stream;

int main( void )
{
   int    i = 10;
   double fp = 1.5;
   char   s[] = "this is a string";
   char   c = '\n';

   fopen_s( &stream, "fprintf_s.out", "w" );
   fprintf_s( stream, "%s%c", s, c );
   fprintf_s( stream, "%d\n", i );
   fprintf_s( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf_s.out" );
}