_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

아티클
06/09/2015

서식을 지정하고 콘솔에 출력합니다. 더 안전한 버전을 사용할 수 있습니다. _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l 를 참조하십시오.

중요

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

int _cprintf( 
   const char * format [, 
   argument] ... 
);
int _cprintf_l( 
   const char * format,
   locale_t locale [,
   argument] … 
);
int _cwprintf(
   const wchar * format [, 
   argument] …
);
int _cwprintf_l(
   const wchar * format,
   locale_t locale [, 
   argument] …
);

매개 변수

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

반환 값

출력된 문자의 수입니다.

설명

이러한 함수는 출력 문자에 대해 _putch 함수를 사용하여 ( _cwprintf에 대한_putwch ) 서식을 지정하고 일련의 문자와 값을 콘솔에 직접 출력합니다. 각 argument(있는 경우)가 format의 해당 형식 사양에 따라 변환되어 출력됩니다. printf 함수에 대해 포맷은 format 매개 변수와 같은 양식과 함수를 가집니다. fprintf, printf, 및 sprintf 와 다르게 _cprintf 또는 _cwprintf 는 출력시 line-feed 문자를 캐리지 return-line feed(CR-LF) 조합으로 변환하지 않습니다.

중요 한 차이점은 _cwprintf 가 Windows NT 사용되는 경우 유니코드 문자를 표시한다는 것입니다. _cprintf 와 달리, _cwprintf 는 현재 콘솔 로캘 설정을 사용합니다.

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

_cprintf 는 format 매개 변수의 유효성을 검사합니다. format 이 null 포인터인 경우 매개 변수 유효성 검사에 설명된 대로 함수는 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 함수는 -1을 반환하고 errno를 EINVAL로 설정합니다.

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

제네릭 텍스트 라우팅 매핑

Tchar.h 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

요구 사항

루틴	필수 헤더
_cprintf,_cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

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

예제

// crt_cprintf.c
// compile with: /c
// This program displays some variables to the console.

#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( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}