_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l

Makale
06/09/2015

Bağımsız değişkenler listesine bir işaretçi kullanarak konsola biçimlendirilmiş çıktı yazar.Bu _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l sürümlerinde CRT'deki Güvenlik Özellikleri içinde açıklandığı gibi güvenlik geliştirmeleri mevcut olabilir.

Ö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(
   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şken listesine yönelik işaretçi.
locale
Kullanılacak yerel ayar.

Daha fazla bilgi için bkz. Biçim Belirtim Sözdizimi: printf ve wprintf İşlevleri.

Dönüş Değeri

Bir hata olması durumunda, yazılan karakter veya negatif bir çıkış değeri sayısı.

Bu işlevlerin daha az güvenli sürümleri gibi, format null bir işaretçiyse Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.Ayrıca, bu işlevlerin daha az güvenli sürümlerinin aksine, format geçerli bir biçim belirlemezse, geçersiz bir parametre özel durumu oluşturulur.Yürütmenin devam etmesine izin verilirse, bu işlevler bir hata kodu döndürür ve errno öğesini bu hata koduna ayarlar.Varsayılan hata kodu, daha özgül bir değer geçerli değilse EINVAL'dır.

Notlar

Bu işlevlerin her biri bağımsız değişken listesi için bir işaretçi alır ve sonra verilen verileri biçimlendirir ve konsola yazar._vcwprintf_s_vcprintf_s öğ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_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ı üst bilgiler
_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 uyumluluğu için gerekli.

Ek uyumluluk bilgileri için bkz. Uyumluluk.

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