vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l

Makale
02/26/2013

Bir bağımsız değişkenler listesindeki bir işaretçi kullanarak biçimlendirilmiş çıktı yaz.Bunlar sürümleridir vsnprintf, _vsnprintf, _vsnprintf_l, _vsnwprintf, _vsnwprintf_l açıklandığı gibi güvenlik geliştirmeleri ile crt güvenlik özellikleri.

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 konumu.
sizeOfBuffer
Boyutunu buffer bayt çıktı.
count
En fazla sayıda karakter (Sonlandırıcı boş hariç) yazmak için veya _TRUNCATE.
format
Biçim belirtimi.
argptr
Bağımsız değişkenler listesi için işaretçi.
locale
Kullanılacak yerel ayarı.

Daha fazla bilgi için bkz: Biçimi belirtimleri.

Dönüş Değeri

vsnprintf_s,_vsnprintf_s ve _vsnwprintf_s çıkış hata oluşursa Sonlandırıcı boş ya da negatif bir değer içermeyen yazılan karakterlerin sayısını döndürür.vsnprintf_saynıdır _vsnprintf_s.vsnprintf_skullanılan ANSI standardına uyumluluk açısından dahil edilmiştir._vnsprintfgeriye dönük uyumluluk için korunur.

Sonlandırıcı boş veri saklamak için gerekli depolama aşarsa sizeOfBuffer, geçersiz parametre işleyicisi, açıklandığı şekilde çağrılır Parametre doğrulamasürece, count olan _TRUNCATE, durumda çok dize gibi Sığdır buffer yazılır ve döndürülen -1.Geçersiz parametre işleyicisi sonra yürütme devam ederse, bu işlevler kümesi buffer boş bir dize olarak errno için ERANGEve -1 döndürür.

buffer Veya format olan bir NULL işaretçisi, veya count küçük veya eşit ise sıfır olarak geçersiz parametre işleyicisi çağrılır.Yürütülmesine devam etmek için izin verilmişse, bu işlevler kümesi errno için EINVAL ve -1 döndürür.

Hata koşulları

Condition	Return	errno
bufferİş NULL	-1	EINVAL
formatİş NULL	-1	EINVAL
count< = 0	-1	EINVAL
sizeOfBuffertoo small (and count != _TRUNCATE)	-1 (ve buffer boş bir dizeye ayarlayın)	ERANGE

Notlar

Bu işlevlerden her biri için bir bağımsız değişken listesi bir işaretçi alır sonra biçimlendirir ve en çok yazar count için bellek için belirtilen veri karakteri işaret tarafından buffer ve Sonlandırıcı boş değer ekler.

count Olan _TRUNCATE, dize sığacak kadarını bu işlevleri yazabilirsiniz sonra buffer Sonlandırıcı boş bir oda bırakarak oluştu.Tüm dizeyi (Sonlandırıcı null ile) sığıyorsa buffer, sonra da bu işlevleri (Sonlandırıcı boş hariç) yazılmış; karakter sayısını döndürür Aksi halde, bu işlevler, kesme oluştu belirtmek için -1 döndürür.

Bu işlevler ile sürümlerini _l soneki yerine geçerli iş parçacığı yerel geçirilen yerel parametresi kullandıkları dışında aynı.

Güvenlik Notu
Emin format kullanıcı tanımlı bir dize değil.Daha fazla bilgi için bkz: Önleme arabelleğin taşmasına neden.

[!NOT]

Sonlandırıcı boş yer olduğundan emin olmak için emin olun count arabellek uzunluğu veya kullanım'den kesinlikle küçük olan _TRUNCATE.

C++'da, bu işlevler tarafından şablon aşırı kolaylaştırılmıştır; aşırı arabellek uzunluğu otomatik olarak gerçekleştirip (size baðýmsýz deðiþkeni belirtmek gereğini ortadan kaldırır) ve bunlar otomatik olarak yeni, güvenli karşılıkları ile eski, güvenli olmayan işlevler değiştirebilirsiniz.Daha fazla bilgi için bkz. Güvenli şablon aşırı yükleme.

Genel metin yordamı eşlemeleri

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlı değil	Tanımlanan _mbcs	Tanımlanan _UNICODE
_vsntprintf_s	_vsnprintf_s	_vsnprintf_s	_vsnwprintf_s
_vsntprintf_s_l	_vsnprintf_s_l	_vsnprintf_s_l	_vsnwprintf_s_l

.NET Framework Eşdeğeri

Yoktur. Standart c işlevi çağırmak için kullanmak PInvoke. Daha fazla bilgi için bkz: Platform Çağırma örnekleri.

Gereksinimler

Yordamı	Gerekli başlık	İsteğe bağlı üstbilgileri
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> ya da <wchar.h> ve <stdarg.h>	<varargs.h> *

* UNIX v uyumluluk için gereklidir.

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

Ö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, sizeof(buff), _TRUNCATE, formatstring, args);
   printf("nSize: %d, buff: %s\n", nSize, buff);
}

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