_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Makale
03/26/2013

Biçimlendirilmiş çıktının bağımsız değişkenler listesi için bir işaretçi kullanarak konsola yazın.Bu işlevlerin daha güvenli sürümleri için bkz: _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.

Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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

Parametreler

format
Biçim belirtimi.
argptr
Bağımsız değişkenler listesi için işaretçi.
locale
Kullanılacak yerel ayarı.

Daha fazla bilgi için bkz: Biçimi belirtimleri.

Dönüş Değeri

Yazılan karakter sayısını veya çıktı hatası oluşursa, negatif bir değer.format Bir null işaretçi açıklandığı gibi geçersiz bir parametre işleyici çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilip verilmediğini errno ayarlamak EINVAL ve -1 döndürülür.

Notlar

Bu işlevlerden her biri için bir bağımsız değişken listesi bir işaretçi alır sonra biçimlendirir ve verilen veri konsola yazar._vcwprintfgeniş karakter sürümü _vcprintf.Bu bir geniş karakter dizesi bir baðýmsýz deðiþken olarak alýr.

Bu işlevleri sürümlerini _l sonek dışında geçerli yerel ayarı geçirilen yerel ayar parametresi kullandıkları aynı.

Güvenlik Notu
Emin format kullanıcı tanımlı bir dize değil.Daha fazla bilgi için bkz: Kaçınma arabelleğin taşmasına neden.

Genel metin eşlemeleri yordamına girildi

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

Gereksinimler

Yordamı	Gerekli başlık	İsteğe bağlı üstbilgi
_vcprintf, _vcprintf_l	<conio.h> ve <stdarg.h>	<varargs.h> *
_vcwprintf, _vcwprintf_l	<conio.h> veya <wchar.h> ve <stdarg.h>	<varargs.h> *

* UNIX v uyumluluk için gereklidir.

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

Örnek

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