_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

아티클
06/09/2015

형식 스트링에서 형식과 콘솔 출력은 매개변수의 위치를 지원합니다.

중요

이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 CRT 함수를 참조하십시오.

int _cprintf_p( 
   const char * format [, 
   argument] ... 
);
int _cprintf_p_l( 
   const char * format,
   locale_t locale [, 
   argument] ... 
);
int _cwprintf_p(
   const wchar * format [, 
   argument] ...
);
int _cwprintf_p_l(
   const wchar * format,
   locale_t locale [,
   argument] ...
);

매개 변수

format
형식 컨트롤 문자열입니다.
argument
선택적 매개 변수입니다.
locale
사용할 로캘입니다.

반환 값

인쇄된 문자 수를 반환하거나 오류가 발생하면 음수 값을 반환합니다.

설명

이러한 _putch 함수는 출력 문자에 대해 _putwch 함수를 사용하여 ( 에 대한 ) 서식을 지정하고 일련의 문자와 값을 콘솔에 직접 출력합니다. 각 argument(있는 경우)가 format의 해당 형식 사양에 따라 변환되어 출력됩니다. 이 printf 함수에 대해 포맷은 format 매개 변수와 같은 양식과 함수를 가집니다. 이 _cprintf_p 및 cprintf_s 의 다른 점은 _cprintf_p 가 지원 위치 매개 변수를 지원하는 것입니다. 이는 형식 문자열에서 사용되는 인수의 사용 되는 순서를 지정하는것입니다. 자세한 내용은 printf_p 위치 매개 변수을 참조하십시오.

이 fprintf_p, printf_p, 및 sprintf_p 와 다르게 _cprintf_p 또는 _cwprintf_p 는 출력시 line-feed 문자를 캐리지 return-line feed(CR-LF) 조합으로 변환하지 않습니다. 중요 한 차이점은 _cwprintf_p 가 Windows NT 사용되는 경우 유니코드 문자를 표시한다는 것입니다. 이 _cprintf_p 와 달리, _cwprintf_p 는 현재 콘솔 로캘 설정을 사용합니다.

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

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

또한, _cprintf_s 및 _cwprintf_s 는 입력된 포인터 및 형식 문자열의 유효성을 검사 합니다. format 또는 argument 는 NULL일 경우, 매개 변수 유효성 검사 에서 형식 문자열에 잘못 된 형식 문자는 이러한 함수에 설명 된대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 이러한 함수는 -1을 반환하고 errno를 EINVAL로 설정합니다.

제네릭 텍스트 라우팅 매핑

Tchar.h 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_tcprintf_p	_cprintf_p	_cprintf_p	_cwprintf_p
_tcprintf_p_l	_cprintf_p_l	_cprintf_p_l	_cwprintf_p_l

요구 사항

루틴	필수 헤더
_cprintf_p,_cprintf_p_l	<conio.h>
_cwprintf_p,_cwprintf_p_l	<conio.h>

호환성에 대한 자세한 내용은 호환성을 참조하십시오.

예제

// crt_cprintf_p.c
// This program displays some variables to the console
// using the _cprintf_p function.

#include <conio.h>

int main( void )
{
    int         i = -16,
                h = 29;
    unsigned    u = 62511;
    char        c = 'A';
    char        s[] = "Test";

    // Note that console output does not translate
    // \n as standard output does. Use \r\n instead.
    _cprintf_p( "%2$d  %1$.4x  %3$u  %4$c %5$s\r\n", 
                h, i, u, c, s );
}