fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

아티클
02/21/2013

서식이 지정 된 데이터 스트림에 인쇄 합니다.이러한 버전의 있습니다 않는다면, _fprintf_l, fwprintf, _fwprintf_l 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.

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, the format 인수가 있는 동일한 구문 및 여가에 사용 printf_s.

fwprintf_s와이드 문자 버전입니다 fprintf_s. fwprintf_s, format 와이드 문자 문자열입니다.스트림에서 ANSI 모드에서 열려 있는 경우 이러한 함수를 동일 하 게 동작 합니다.fprintf_s현재 출력 스트림으로 유니코드를 지원 하지 않습니다.

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

보안 정보
확인 format 사용자 정의 문자열이 아닙니다.

다음과 같이 안전 하지 않은 버전 (를 참조 하십시오 않는다면, _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" );
}