fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_lfprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

형식이 지정된 데이터를 스트림에 출력합니다.Print formatted data to a stream. 이러한 함수는 CRT의 보안 기능에 설명된 대로 강화된 보안 기능이 있는 fprintf, _fprintf_l, fwprintf, _fwprintf_l의 버전입니다.These are versions of fprintf, _fprintf_l, fwprintf, _fwprintf_l with security enhancements as described in Security Features in the CRT.

구문Syntax

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

매개 변수Parameters

streamstream
FILE 구조체에 대한 포인터입니다.Pointer to FILE structure.

formatformat
형식 컨트롤 문자열입니다.Format-control string.

argument_listargument_list
서식 문자열에 대 한 선택적 인수입니다.Optional arguments to the format string.

localelocale
사용할 로캘입니다.The locale to use.

반환 값Return Value

fprintf_s 는 쓴 바이트 수를 반환 합니다.fprintf_s returns the number of bytes written. fwprintf_s 는 쓴 와이드 문자 수를 반환 합니다.fwprintf_s returns the number of wide characters written. 이러한 각 함수는 출력 오류가 발생할 때 대신 음수 값을 반환합니다.Each of these functions returns a negative value instead when an output error occurs.

설명Remarks

fprintf_s 는 일련의 문자와 값을 출력 스트림에서식 지정 하 고 인쇄 합니다.fprintf_s formats and prints a series of characters and values to the output stream. Argument_list 의 각 인수 (있는 경우)는 형식의 해당 형식 사양에 따라 변환 되 고 출력 됩니다.Each argument in argument_list (if any) is converted and output according to the corresponding format specification in format. Format 인수는 printf 및 wprintf 함수에 대 한 형식 지정 구문을사용 합니다.The format argument uses the format specification syntax for printf and wprintf functions.

fwprintf_sfprintf_s의 와이드 문자 버전입니다. fwprintf_s에서 format 은 와이드 문자 문자열입니다.fwprintf_s is a wide-character version of fprintf_s; in fwprintf_s, format is a wide-character string. 스트림이 ANSI 모드에서 열리는 경우 이러한 함수는 동일하게 작동합니다.These functions behave identically if the stream is opened in ANSI mode. fprintf_s 는 현재 유니코드 스트림에 대 한 출력을 지원 하지 않습니다.fprintf_s doesn't currently support output into a UNICODE stream.

_L 접미사가 있는 이러한 함수 버전은 현재 로캘 대신 전달 된 로캘 매개 변수를 사용 한다는 점을 제외 하 고는 동일 합니다.The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current locale.

중요

format이 사용자 정의 문자열이 아닌지 확인하세요.Ensure that format is not a user-defined string.

안전 하지 않은 버전 ( fprintf, _fintf_l, fwprintf, _fwprintf_l참조)과 마찬가지로 이러한 함수는 매개 변수 유효성을검사 하 고 스트림 또는 format 은 null 포인터입니다.Like the non-secure versions (see fprintf, _fprintf_l, fwprintf, _fwprintf_l), these functions validate their parameters and invoke the invalid parameter handler, as described in Parameter Validation, if either stream or format is a null pointer. 서식 문자열 자체의 유효성도 검사 됩니다.The format string itself is also validated. 알 수 없거나 잘못된 형식의 형식 지정자가 있는 경우 이러한 함수는 잘못된 매개 변수 예외를 생성합니다.If there are any unknown or badly formed formatting specifiers, these functions generate the invalid parameter exception. 모든 경우에서 계속 해 서 실행 하도록 허용한 경우 함수는-1을 반환 하 고 errnoEINVAL로 설정 합니다.In all cases, If execution is allowed to continue, the functions return -1 and set errno to EINVAL. 이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr를 참조하세요.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

제네릭 텍스트 루틴 매핑Generic-Text Routine Mappings

TCHAR.H 루틴TCHAR.H routine _UNICODE 및 _MBCS 정의되지 않음_UNICODE & _MBCS not defined _MBCS 정의됨_MBCS defined _UNICODE 정의됨_UNICODE defined
_ftprintf_s_ftprintf_s fprintf_sfprintf_s fprintf_sfprintf_s fwprintf_sfwprintf_s
_ftprintf_s_l_ftprintf_s_l _fprintf_s_l_fprintf_s_l _fprintf_s_l_fprintf_s_l _fwprintf_s_l_fwprintf_s_l

자세한 내용은 형식 사양을 참조하세요.For more information, see Format Specifications.

요구 사항Requirements

기능Function 필수 헤더Required header
fprintf_s, _fprintf_s_lfprintf_s, _fprintf_s_l <stdio.h><stdio.h>
fwprintf_s, _fwprintf_s_lfwprintf_s, _fwprintf_s_l <stdio.h> 또는 <wchar.h><stdio.h> or <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.For additional compatibility information, see Compatibility.

예제Example

// 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" );
}
this is a string
10
1.500000

참고자료See also

스트림 I/OStream I/O
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_lfscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l