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
Çıktı için depolama konumu.

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ı Yok 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 Yok 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) Yes
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) Yes
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ı. Yok 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ı. Yok Hayır
count < sizeOfBuffer ve len <= count Tüm veriler yazılır ve sonlandırıcı NULL eklenir. Yazılan karakter sayısı. Yok Hayır
count < sizeOfBuffer ve len > count İlk count karakterler yazılır. -1 Yok 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ı. Yok 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) Yes
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 Yok Hayır
count == _TRUNCATE ve len < sizeOfBuffer dizenin tamamını sonlandırıcı NULLile içine buffer yazar. Yazılan karakter sayısı. Yok 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) Yes

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.

Not

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.

İpucu

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 olağan _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