_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

아티클
03/15/2013

서식을 지정 하 고 형식 문자열에서 위치 매개 변수를 지 원하는 콘솔에 출력 합니다.

중요
이 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.형식 같은 형성 및 역할을 가진의 format 매개 변수는 printf_p 함수.차이 _cprintf_p 및 cprintf_s 는 _cprintf_p 형식 문자열에 인수를 사용 하는 순서를 지정할 수 있도록 지 원하는 위치 매개.자세한 내용은 printf_p Positional 매개 변수을 참조하십시오.

달리는 fprintf_p, printf_p, 및 sprintf_p 둘 다 작동 _cprintf_p 또는 _cwprintf_p 줄 바꿈 문자 (CR LF) 조합을 공급 캐리지 return–line로 변환 출력 시.중요 한 차이입니다 _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 );
}