_vcprintf_s
, _vcprintf_s_l
, _vcwprintf_s
, _vcwprintf_s_l
Biçimlendirilmiş çıkışı, bağımsız değişken listesinin işaretçisini kullanarak konsola yazar. Bu , _vcprintf_l
, , _vcwprintf_l
_vcwprintf
sürümlerinin_vcprintf
, CRT'deki Güvenlik özellikleri bölümünde açıklandığı gibi güvenlik geliştirmeleri vardır.
Önemli
Bu API, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.
Sözdizimi
int _vcprintf_s(
char const* const format,
va_list argptr
);
int _vcprintf_s_l(
char const* const format,
_locale_t locale,
va_list argptr
);
int _vcwprintf_s(
wchar_t const* const format,
va_list argptr
);
int _vcwprintf_s_l(
wchar_t const* const format,
_locale_t locale,
va_list argptr
);
Parametreler
format
Biçim belirtimi.
argptr
Bağımsız değişken listesinin işaretçisi.
locale
Kullanılacak yerel ayar.
Daha fazla bilgi için bkz . Biçim belirtimi söz dizimi: printf
ve wprintf
işlevleri.
Dönüş değeri
Yazılan karakter sayısı veya bir çıkış hatası oluşursa negatif bir değer.
Bu işlevlerin daha az güvenli sürümleri gibi, null bir işaretçiyseformat
, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Ayrıca, bu işlevlerin daha az güvenli sürümlerinden farklı olarak, format
geçerli bir biçim belirtmezse geçersiz bir parametre özel durumu oluşturulur. Yürütmenin devam etmesi için izin verilirse, bu işlevler bir hata kodu döndürür ve bu hata koduna ayarlanır errno
. Varsayılan hata kodu, daha belirli bir değerin geçerli olmamasıdır EINVAL
.
Açıklamalar
Bu işlevlerin her biri bir bağımsız değişken listesinin işaretçisini alır ve verilen verileri biçimlendirip konsola yazar. _vcwprintf_s
, öğesinin geniş karakterli sürümüdür _vcprintf_s
. Bağımsız değişken olarak geniş karakterli bir dize alır.
Bu işlevlerin son ekine _l
sahip sürümleri, geçerli yerel ayar yerine geçirilen yerel ayar parametresini kullanmaları dışında aynıdır.
Önemli
format
Kullanıcı tanımlı bir dize olmadığından emin olun. Daha fazla bilgi için bkz . Arabellek taşmalarından kaçınma.
Genel metin yordamı eşlemeleri
TCHAR.H yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_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 gereklidir.
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Önemli
Windows 10 sürüm 2004 'den (derleme 19041) printf
başlayarak, işlev ailesi yuvarlama için IEEE 754 kurallarına göre tam olarak temsil edilebilir kayan nokta numaraları yazdırır. Windows'un önceki sürümlerinde, '5' ile biten tam olarak temsil edilebilir kayan nokta sayıları her zaman yukarı yuvarlanırdı. IEEE 754, en yakın çift rakama ("Bankacı Yuvarlama" olarak da bilinir) yuvarlamaları gerektiğini belirtir. Örneğin, hem hem de printf("%1.0f", 1.5)
printf("%1.0f", 2.5)
2'ye yuvarlanmalıdır. Daha önce 1,5 2'ye, 2,5 ise 3'e yuvarlardı. Bu değişiklik yalnızca tam olarak temsil edilebilir sayıları etkiler. Örneğin, 2,35 (bellekte temsil edildiğinde 2,3500000000000000000008'e daha yakındır) 2,4'e kadar yuvarlanmaya devam eder. Bu işlevler tarafından yapılan yuvarlama artık tarafından fesetround
ayarlanan kayan nokta yuvarlama moduna da dikkat eder. Daha önce yuvarlama her zaman davranışı seçmişti FE_TONEAREST
. Bu değişiklik yalnızca Visual Studio 2019 sürüm 16.2 ve üzeri kullanılarak oluşturulan programları etkiler. Eski kayan nokta yuvarlama davranışını kullanmak için ile legacy_stdio_float_rounding.obj
bağlayın.
Ö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);
int result = _vcprintf_s(format, args);
va_end(args);
return result;
}
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 );
}
(10,23): Error C2111 : <some error text>
(Related to symbol '<symbol>' defined on line 5).
Ayrıca bkz.
Akış G/Ç
vprintf
işlevleri
_cprintf
, _cprintf_l
, _cwprintf
, _cwprintf_l
fprintf
, _fprintf_l
, fwprintf
, _fwprintf_l
printf
, _printf_l
, wprintf
, _wprintf_l
sprintf
, _sprintf_l
, swprintf
, _swprintf_l
, , __swprintf_l
va_arg
, va_copy
, va_end
, va_start