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.

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

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.

Genel metin yordamı eşlemeleri

Gereksinimler

* 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