Aracılığıyla paylaş

vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

  • Makale

Biçimlendirilmiş çıkışı, bir bağımsız değişken listesine işaretçi kullanarak yazar. Bu , _vprintf_l, , _vwprintf_l vwprintfsürümlerininvprintf, CRT'deki Güvenlik özellikleri bölümünde açıklandığı gibi güvenlik geliştirmeleri vardır.

Sözdizimi

int vprintf_s(
   const char *format,
   va_list argptr
);
int _vprintf_s_l(
   const char *format,
   _locale_t locale,
   va_list argptr
);
int vwprintf_s(
   const wchar_t *format,
   va_list argptr
);
int _vwprintf_s_l(
   const wchar_t *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.

Dönüş değeri

vprintf_s ve vwprintf_s sonlandırıcı null karakter veya bir çıkış hatası oluşursa negatif değer dahil olmak üzere yazılan karakter sayısını döndürebilirsiniz. Boş bir işaretçiyse format veya biçim dizesi geçersiz biçimlendirme karakterleri içeriyorsa, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, işlevler -1 döndürür ve olarak EINVALayarlanırerrno.

Bunlar ve diğer hata kodları hakkında bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

Bu işlevlerin her biri bir bağımsız değişken listesinin işaretçisini alır, ardından verilen verileri biçimlendirip öğesine stdoutyazar.

Bu işlevlerin güvenli sürümleri, yalnızca güvenli sürümlerin biçim dizesinin geçerli biçimlendirme karakterleri içerip içermediğini denetlemesinden vprintf vwprintf farklıdır.

vwprintf_s , öğesinin vprintf_sgeniş karakterli sürümüdür; akış ANSI modunda açıldığında iki işlev aynı şekilde davranır. vprintf_s şu anda UNICODE akışına çıkışı desteklemez.

Bu işlevlerin sonekli _l sürümleri aynıdır, ancak geçerli iş parçacığı yerel ayarı yerine geçirilen yerel ayar parametresini kullanırlar.

Önemli

format Kullanıcı tanımlı bir dize olmadığından emin olun. Daha fazla bilgi için bkz . Arabellek taşmalarından kaçınma. 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 fesetroundayarlanan 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 'legacy_stdio_float_rounding.obj' ile bağlantı sağlayın.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı _UNICODE ve _MBCS tanımlanmadı _MBCS tanımlanan _UNICODE tanımlanan
_vtprintf_s vprintf_s vprintf_s vwprintf_s
_vtprintf_s_l _vprintf_s_l _vprintf_s_l _vwprintf_s_l

Gereksinimler

Yordam Gerekli başlık İsteğe bağlı üst bilgiler
vprintf_s, _vprintf_s_l <stdio.h> ve <stdarg.h> <varargs.h>*
vwprintf_s, _vwprintf_s_l <stdio.h> veya <wchar.h> ve <stdarg.h> <varargs.h>*

* UNIX V uyumluluğu için gereklidir.

Konsol Evrensel Windows Platformu (UWP) uygulamalarında desteklenmez. C çalışma zamanı işlevlerinin UWP uygulamalarında kullanabilmesi için önce konsolu stdin, , stdoutve stderrile ilişkilendirilmiş standart akış tanıtıcılarının yeniden yönlendirilmesi gerekir. Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Ayrıca bkz.

Akış G/Ç
vprintf işlevleri
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