_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Artykuł
03/26/2013

Napisz sformatowane dane wyjściowe do konsoli za pomocą wskaźnika do listy argumentów.Dostępne są bardziej bezpieczne wersje tych funkcji, zobacz _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.

Ważne
Ten interfejs API nie można używać w aplikacji, których wykonywanie w czasie wykonywania systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /ZW.

int _vcprintf(
   const char* format,
   va_list argptr
);
int _vcprintf_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_l(
   const wchar_t* format,
   locale_t locale,
   va_list argptr
);

Parametry

format
Specyfikacja formatu.
argptr
Wskaźnik do listy argumentów.
locale
Ustawienia regionalne używane.

Aby uzyskać więcej informacji, zobacz Specyfikacji formatu.

Wartość zwracana

Niektóre znaki pisane, lub wartość ujemną, jeśli wystąpi błąd danych wyjściowych.Jeśli format jest pusty wskaźnik, program obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, errno jest ustawiona na EINVAL i zwracana jest wartość -1.

Uwagi

Każda z tych funkcji ma wskaźnik do listy argumentów, a następnie formatuje i zapisuje dane podawane do konsoli._vcwprintfjest to wersja szerokich znaków _vcprintf.Trwa łańcuch szerokich znaków jako argument.

Wersje te funkcje za pomocą _l sufiks są identyczne z tym, że używają parametru ustawień regionalnych, przekazany zamiast bieżących ustawień regionalnych.

Uwaga dotycząca zabezpieczeń
Zapewnienia, że format nie jest ciągiem zdefiniowane przez użytkownika.Aby uzyskać więcej informacji, zobacz Unikanie przekroczeniem buforu.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE & _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka	Nagłówki opcjonalne
_vcprintf, _vcprintf_l	<conio.h> i <stdarg.h>	<varargs.h> *
_vcwprintf, _vcwprintf_l	<conio.h> lub <wchar.h> i <stdarg.h>	<varargs.h> *

* Wymagana w przypadku zgodności V systemu UNIX.

Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

Przykład

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

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

int main()
{
   eprintf("  (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
           "<some error text>");
   eprintf("  (Related to symbol '%s' defined on line %d).\n",
           "<symbol>", 5 );
}