_vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l
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 );
}
.NET Framework Eşdeğeri
Ayrıca bkz.
Başvuru
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l