vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l

Bir bağımsız değişken listesinin işaretçisini kullanarak biçimlendirilmiş çıktı yazın. Bu işlevler, CRT'deki Güvenlik özellikleri bölümünde açıklandığı gibi güvenlik geliştirmeleri içeren , _vsnprintf_l_vsnprintf, , , _vsnwprintf_l_vsnwprintf sürümleridir.vsnprintf

Sözdizimi

int vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s_l(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   _locale_t locale,
   va_list argptr
);

int _vsnwprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   va_list argptr
);

int _vsnwprintf_s_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

template <size_t size>
int _vsnprintf_s(
   char (&buffer)[size],
   size_t count,
   const char *format,
   va_list argptr
); // C++ only

template <size_t size>
int _vsnwprintf_s(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr
); // C++ only

Parametreler

buffer
Çıkış için Depolama konum.

sizeOfBuffer
çıktısının buffer boyutu. alan işlevlerin bayt cinsinden boyutu ve kullananlar wchar_tiçin sözcükler.char

count
Sonlandırıcı NULLdahil olmak üzere yazılmayacak karakter sayısı üst sınırı. öğesini alan wchar_tişlevler için, yazacak geniş karakter sayısıdır. Veya ._TRUNCATE

format
Biçim belirtimi.

argptr
Bağımsız değişken listesinin işaretçisi.

locale
Çıkışı biçimlendirirken kullanılacak yerel ayar.

Daha fazla bilgi için bkz . Biçim belirtimleri.

Dönüş değeri

Sonlandırıcı NULLdahil değil, yazılan karakter sayısı veya bir çıkış hatası oluşursa negatif bir değer.

Ayrıntılar için bkz . Davranış özeti .

Açıklamalar

vsnprintf_s ile aynıdır _vsnprintf_s ve ANSI standardına uygunluk için dahil edilir. _vnsprintf geriye dönük uyumluluk için korunur.

Bu işlevlerin her biri bir bağımsız değişken listesinin işaretçisini alır, ardından verilen verilerin karakterlerini tarafından işaret edilen buffer belleğe biçimlendirip yazar count ve sonlandırıcı null ekler.

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.

Davranış özeti

Aşağıdaki tablo için:

• len Biçimlendirilmiş verilerin boyutu olsun. İşlev bir char arabellek alırsa boyut bayt cinsindendir. İşlev bir wchar_t arabellek alırsa, boyut 16 bit sözcük sayısını belirtir.
• Karakterler, arabelleğe alınan char işlevlerin karakterlerine wchar_t ve arabelleğe alınan wchar_t işlevlere yönelik karakterlere başvururchar.
• Geçersiz parametre işleyicisi hakkında daha fazla bilgi için bkz . Parametre Doğrulama.

Koşul	Davranış	Dönüş değeri	errno	Geçersiz parametre işleyicisini çağırır
Başarılı	Belirtilen biçim dizesini kullanarak karakterleri arabelleğe yazar	Yazılan karakter sayısı	Geçersiz	Hayır
Biçimlendirme sırasında kodlama hatası	Dize tanımlayıcısı s, , Sveya Z, biçimlendirme belirtimi işleme durdurulursa.	-1	EILSEQ (42)	Hayır
Biçimlendirme sırasında kodlama hatası	Karakter tanımlayıcısı c veya Cişleniyorsa geçersiz karakter atlanır. Yazılan karakter sayısı, atlanan karakter için artırılmıyor ve bu karakter için yazılan veri yok. Biçim belirtimi işleme, tanımlayıcıyı kodlama hatasıyla atladıktan sonra devam eder.	Sonlandırıcı NULLdahil değil, yazılan karakter sayısı.	EILSEQ (42)	Hayır
buffer == NULLve ve sizeOfBuffer == 0count == 0	Hiçbir veri yazılmıştır.	0	Geçersiz	Hayır
buffer == NULLsizeOfBuffer != 0 ve veyacount != 0	Geçersiz parametre işleyicisi yürütülürken yürütme devam ederse, negatif bir değer ayarlar errno ve döndürür.	-1	EINVAL (22)	Evet
buffer != NULL ve sizeOfBuffer == 0	Hiçbir veri yazılmıştır. Geçersiz parametre işleyicisi yürütülürken yürütme devam ederse, negatif bir değer ayarlar errno ve döndürür.	-1	EINVAL (22)	Evet
count == 0	Hiçbir veri yazmaz ve sonlandırıcı NULLdahil olmak üzere yazılmış olabilecek karakter sayısını döndürür.	Sonlandırıcı NULLdahil olmak üzere yazılabilecek karakter sayısı.	Geçersiz	Hayır
count < 0	Güvenli değil: değer işaretsiz olarak kabul edilir ve büyük olasılıkla arabelleğinden sonra gelen belleğin üzerine yazılmasıyla sonuçlanan büyük bir değer oluşturur.	Sonlandırıcı NULLdahil değil, yazılan karakter sayısı.	Geçersiz	Hayır
count < sizeOfBuffer ve len <= count	Tüm veriler yazılır ve sonlandırıcı NULL eklenir.	Yazılan karakter sayısı.	Geçersiz	Hayır
count < sizeOfBuffer ve len > count	İlk count karakterler yazılır.	-1	Geçersiz	Hayır
count >= sizeOfBuffer ve len < sizeOfBuffer	Tüm veriler sonlandırıcı NULLile yazılır.	Sonlandırıcı NULLdahil değil, yazılan karakter sayısı.	Geçersiz	Hayır
count >= sizeOfBufferve ve len >= sizeOfBuffercount != _TRUNCATE	Geçersiz parametre işleyicisi yürütülürken yürütme devam ederse, öğesini ayarlar errnobuffer[0] == NULLve negatif bir değer döndürür.	-1	ERANGE (34)	Evet
count == _TRUNCATE ve len >= sizeOfBuffer	Dizenin sığacak bufferkadar büyük bir kısmını, sonlandırıcısı NULLda dahil olmak üzere yazar.	-1	Geçersiz	Hayır
count == _TRUNCATE ve len < sizeOfBuffer	dizenin tamamını sonlandırıcı NULLile içine buffer yazar.	Yazılan karakter sayısı.	Geçersiz	Hayır
format == NULL	Hiçbir veri yazılmıştır. Geçersiz parametre işleyicisi yürütülürken yürütme devam ederse, negatif bir değer ayarlar errno ve döndürür.	-1	EINVAL (22)	Evet

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

Ö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.

Dekont

Sonlandırıcı null için yer olduğundan emin olmak için arabellek uzunluğundan count kesinlikle daha az olduğundan emin olun veya kullanın _TRUNCATE.

C++'ta bu işlevlerin kullanılması şablon aşırı yüklemeleriyle basitleştirilir; aşırı yüklemeler arabellek uzunluğunu otomatik olarak çıkarabilir (boyut bağımsız değişkeni belirtme gereksinimini ortadan kaldırır) ve eski, güvenli olmayan işlevleri yeni ve güvenli karşılıklarıyla otomatik olarak değiştirebilir. Daha fazla bilgi için bkz . Güvenli şablon aşırı yüklemeleri.

Bahşiş

Tanımlanmamış bir dış _vsnprintf_s hata alırsanız ve Universal C Çalışma Zamanı'nı kullanıyorsanız, bağlanmak için kitaplık kümesine ekleyin legacy_stdio_definitions.lib . Evrensel C Çalışma Zamanı bu işlevi doğrudan dışarı aktarmaz ve bunun yerine içinde <stdio.h>satır içinde tanımlanır. Daha fazla bilgi için bkz . Olası yükseltme sorunlarına genel bakış ve Visual Studio 2015 uyumluluk değişiklikleri.

Genel metin yordamı eşlemeleri

TCHAR.H Rutin	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_vsntprintf_s	_vsnprintf_s	_vsnprintf_s	_vsnwprintf_s
_vsntprintf_s_l	_vsnprintf_s_l	_vsnprintf_s_l	_vsnwprintf_s_l

Gereksinimler

Yordam	Gerekli başlık	İsteğe bağlı üst bilgiler
vsnprintf_s	<stdio.h> ve <stdarg.h>	<varargs.h>*
_vsnprintf_s, _vsnprintf_s_l	<stdio.h> ve <stdarg.h>	<varargs.h>*
_vsnwprintf_s, _vsnwprintf_s_l	<stdio.h> veya <wchar.h>ve <stdarg.h>	<varargs.h>*

* UNIX V uyumluluğu için gereklidir.

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

// crt_vsnprintf_s.cpp
#include <stdio.h>
#include <wtypes.h>

void FormatOutput(LPCSTR formatstring, ...)
{
   int nSize = 0;
   char buff[10];
   memset(buff, 0, sizeof(buff));
   va_list args;
   va_start(args, formatstring);
   nSize = vsnprintf_s( buff, _countof(buff), _TRUNCATE, formatstring, args);
   printf("nSize: %d, buff: %s\n", nSize, buff);
   va_end(args);
}

int main() {
   FormatOutput("%s %s", "Hi", "there");
   FormatOutput("%s %s", "Hi", "there!");
   FormatOutput("%s %s", "Hi", "there!!");
}

nSize: 8, buff: Hi there
nSize: 9, buff: Hi there!
nSize: -1, buff: Hi there!

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