_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l

인수 목록에 대 한 포인터를 사용 하 여 형식이 지정 된 출력을 콘솔에 씁니다 및 형식 문자열에서 위치 매개 변수를 지원 합니다.

중요
이 API를 실행 하는 응용 프로그램에서 사용할 수 있는 Windows 런타임.자세한 내용은 /zw에 지원 되는 CRT 함수.

int _vcprintf_p(
   const char* format,
   va_list argptr
);
int _vcprintf_p_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_p(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_p_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

매개 변수

• format
  형식 사양입니다.

• argptr
  인수 목록에 대 한 포인터입니다.

• locale
  사용 하는 로캘.

자세한 내용은 형식 사양 구문: printf 및 wprintf 함수을 참조하십시오.

반환 값

작성 된 문자의 개수 또는 출력 오류가 발생 하는 경우 음수 값입니다.경우 format 는 null 포인터에 설명 된 대로 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사.실행을 계속 하려면 허용 되는 경우 errno 로 설정 된 EINVAL 가-1을 반환 합니다.

설명

이러한 각 함수는 인수 목록에 대 한 포인터를 사용 하는 _putch 함수를 서식을 지정 하 고 해당된 데이터를 콘솔에 씁니다.(_vcwprintf_p uses _putwch instead of _putch._vcwprintf_p와이드 문자 버전인 _vcprintf_p.이 와이드 문자 문자열을 인수로 사용 합니다.)

버전의 이러한 함수는 _l 접미사는 전달 된 로캘 매개 변수 대신 현재 로캘을 사용 하는 것을 제외 하 고 동일 합니다.

각 argument (있는 경우) 변환 되 고 해당 형식 사양에 따라 출력은 format.형식 문자열에는 인수가 사용 되는 순서를 지정할 수 있도록 형식 사양 위치 매개 변수를 지원 합니다.자세한 내용은 printf_p Positional 매개 변수을 참조하십시오.

이러한 함수 출력 때 줄 바꿈 문자가 캐리지 리턴-줄 바꿈 (CR-LF) 조합으로 번역 하지 마십시오.

보안 정보
되도록 format 사용자 정의 하는 문자열이 아닙니다.자세한 내용은 버퍼 오버런 방지.

이러한 함수 입력된 포인터 및 형식 문자열의 유효성을 검사 합니다.경우 format 또는 argument 는 NULL, 형식 문자열 서식 잘못 된 문자가 포함 되어 있으면 이러한 함수는 잘못 된 매개 변수 처리기의 설명에 따라 호출 하거나 매개 변수 유효성 검사.이러한 함수 실행을 계속 허용 되 면-1을 반환 하 고 설정 errno 에 EINVAL.

일반 텍스트 루틴 매핑

요구 사항

자세한 호환성에 대 한 내용은 호환성.

예제

// crt_vcprintf_p.c
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function that's used to print to the console.
int eprintf(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf_p(format, args);
}

int main()
{
   int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
      "one", 222);
   _cprintf_s("%d characters printed\r\n");
}

참고 항목

참조

콘솔 및 포트 I/O

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

va_start, va_end, va_arg

printf_p Positional 매개 변수