_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Makale
06/09/2015

Bağımsız değişkenler listesine bir işaretçi kullanarak konsola biçimlendirilmiş çıktı yazar.Bu işlevlerin daha güvenli sürümleri mevcuttur, bkz. _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.

Önemli
Bu API, Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamaz.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

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 listesine işaretçi.
locale
Kullanılacak yerel ayar.

Daha fazla bilgi için bkz. Biçim Belirtimleri.

Dönüş Değeri

Bir hata olması durumunda, yazılan karakter veya negatif bir çıkış değeri sayısı.format bir null işaretçiyse, Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.Yürütmenin devam etmesine izin verilirse, errno öğesi EINVAL olarak ayarlanır ve -1 döndürülür.

Notlar

Bu işlevlerin her biri bağımsız değişken listesi için bir işaretçi alır, sonra verilen verileri biçimlendirir ve konsola yazar._vcwprintf_vcprintf öğesinin geniş karakterli sürümüdür.Geniş karakter dizesini bağımsız değişken olarak alır.

_l sonekine sahip bu işlevlerin sürümleri, geçerli yerel ayarı yerine iletilen yerel ayar parametresini kullanmalarıdır.

Güvenlik Notu
format öğesinin bir kullanıcı tanımlı dize olmadığından emin olun.Daha fazla bilgi için, bkz. Arabellek Taşmalarını Önleme.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı	_UNICODE & _MBCS tanımlanmamış	_MBCS tanımlanmış	_UNICODE tanımlanmış
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

Gereksinimler

Yordam	Gerekli başlık	İsteğe bağlı üst bilgiler
_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 uyumluluğu için gerekli.

Ek uyumluluk bilgileri için bkz. Uyumluluk.

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