_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Artykuł
06/09/2015

Wpisuje sformatowane dane wyjściowe to konsoli za pomocą wskaźnika do listy argumentów.Bardziej bezpieczne wersje tych funkcji są dostępne w _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.

Ważne
Tego API nie można używać w aplikacjach korzystających ze środowiska wykonawczego Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsł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
Format specyfikacji.
argptr
Wskaźnik na listę argumentów.
locale
Ustawienia regionalne do użycia.

Aby uzyskać więcej informacji na temat ciągów formatujących, zobacz Specyfikacje formatu.

Wartość zwracana

Liczba znaków pisanych lub wartość ujemna, jeśli wystąpi błąd danych wyjściowych.Jeśli format jest pustym wskaźnikiem, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, errno jest ustawione jako EINVAL, a -1 jest zwracane.

Uwagi

Każda z tych funkcji pobiera wskaźnik do listy argumentów, następnie formatuje i zapisuje dostarczone dane do konsoli._vcwprintf to wersja znaków dwubajtowych _vcprintf.Pobiera ciąg znaków dwubajtowych jako argument.

Wersje tych funkcji, które mają przyrostek _l są identyczne, z tą różnicą, że korzystają z przekazanego parametru ustawień regionalnych, zamiast bieżących ustawień regionalnych.

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

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE & _MBCS nie zdefiniowano	_MBCS zdefiniowano	_UNICODE zdefiniowany
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

Wymagania

Procedura	Wymagany nagłówek	Opcjonalne nagłówki
_vcprintf, _vcprintf_l	<conio.h> i <stdarg.h>	<varargs.h>*
_vcwprintf, _vcwprintf_l	<conio.h> lub <wchar.h> i <stdarg.h>	<varargs.h>*

* Wymagane dla zgodności systemu UNIX V.

Dodatkowe informacje o zgodności – zobacz: Zgodność.

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 );
}