_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_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.Sürümleri bunlar _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l açıklandığı gibi güvenlik geliştirmeleri ile crt güvenlik özellikleri.

Ö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(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_s(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_s_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.

Bu işlevler, güvenli olmayan sürümü gibi format bir null işaretçi açıklandığı gibi geçersiz bir parametre işleyici çağrılır Parametre doğrulama.Ayrıca, bu işlevler, güvenli olmayan sürümü aksine, format geçerli bir biçim belirtmeyen bir geçersiz parametre özel durum oluşturdu.Bu işlevler dönmek yürütülmesine devam etmek için izin verilip verilmediğini,

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._vcwprintf_sgeniş karakter sürümü _vcprintf_s.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_s	_vcprintf_s	_vcprintf_s	_vcwprintf_s
_vtcprintf_s_l	_vcprintf_s_l	_vcprintf_s_l	_vcwprintf_s_l

Gereksinimler

Yordamı	Gerekli başlık	İsteğe bağlı üstbilgi
_vcprintf_s, _vcprintf_s_l	<conio.h> ve <stdarg.h>	<varargs.h> *
_vcwprintf_s, _vcwprintf_s_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_s.cpp
#include <conio.h>
#include <stdarg.h>

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

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