fprintf, _fprintf_l, fwprintf, _fwprintf_l

아티클
06/09/2015

형식이 지정된 데이터를 스트림에 출력합니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l를 참조하십시오.

int fprintf( 
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int fwprintf( 
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]...
);

매개 변수

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

반환 값

fprintf는 쓴 바이트 수를 반환합니다. fwprintf는 작성 된 와이드 문자의 수를 반환 합니다. 이러한 각 함수는 출력 오류가 발생했을 때 대신 음수 값을 반환합니다. stream 또는 format가 NULL 인 경우 이러한 함수는 매개 변수 유효성 검사 에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 함수는 -1을 반환하고 errno 를 EINVAL로 설정합니다. fprintf_s 또는 fwprintf_s 을 사용하는 경우 형식 문자열에 대해 잘못된 형식의 문자 체크는 하지 않습니다.

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

설명

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

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

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

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

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

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

요구 사항

Function	필수 헤더
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_fprintf.c
/* This program uses fprintf to format various
 * data and print it to the file named FPRINTF.OUT. It
 * then displays FPRINTF.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.out", "w" );
   fprintf( stream, "%s%c", s, c );
   fprintf( stream, "%d\n", i );
   fprintf( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf.out" );
}