_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

아티클
06/09/2015

형식이 지정된 데이터를 스트림에 출력합니다.

int _fprintf_p( 
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_p_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int _fwprintf_p( 
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_p_l( 
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]...
);

매개 변수

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

반환 값

_fprintf_p 및 _fwprintf_p는 쓰인 문자의 수를 반환하거나 출력 오류가 발생하는 경우 음수 값을 반환합니다.

설명

_fprintf_p는 일련의 문자 및 값의 서식을 지정하고 출력 stream에 출력합니다. 각 argument 함수(있는 경우)가 format의 해당 형식 사양에 따라 변환되어 출력됩니다. _fprintf_p에 대해서, format 인수는 _printf_p와 동일한 구문을 사용합니다. 이러한 함수는 형식 문자열에서 사용되는 매개 변수의 순서가 변경될 수 있다는 것을 의미하는 위치 매개 변수를 지원합니다. 위치 매개 변수에 대한 자세한 설명은, printf_p 위치 매개 변수를 참조하십시오.

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

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

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

안전하지 않은 버전(fprintf, _fprintf_l, fwprintf, _fwprintf_l를 참조하십시오)과 같이, 이러한 함수는 매개 변수 유효성 검사에 설명된 것과 같이 stream 또는 format이 널 포인터이거나 혹은 알려지지 않았거나 잘못된 형식의 형식 지정자가 존재하는 경우 매개 변수의 유효성을 검사하고 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 함수는 -1을 반환하고 errno 를 EINVAL로 설정합니다.

제네릭 텍스트 라우팅 매핑

Tchar.h 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_ftprintf_p	_fprintf_p	_fprintf_p	_fwprintf_p
_ftprintf_p_l	_fprintf_p_l	_fprintf_p_l	_fwprintf_p_l

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

요구 사항

Function	필수 헤더
_fprintf_p, _fprintf_p_l	<stdio.h>
_fwprintf_p, _fwprintf_p_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_fprintf_p.c
// This program uses _fprintf_p to format various
// data and print it to the file named FPRINTF_P.OUT. It
// then displays FPRINTF_P.OUT on the screen using the system
// function to invoke the operating-system TYPE command.
// 

#include <stdio.h>
#include <process.h>


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

    // Open the file
    if ( fopen_s( &stream, "fprintf_p.out", "w" ) == 0)
    {
        // Format and print data
        _fprintf_p( stream, "%2$s%1$c", c, s );
        _fprintf_p( stream, "%d\n", i );
        _fprintf_p( stream, "%f\n", fp );

        // Close the file
        fclose( stream );
    }

    // Verify our data
    system( "type fprintf_p.out" );
}