vsnprintf, _vsnprintf, _vsnprintf_l, _vsnwprintf, _vsnwprintf_l

Makale
02/26/2013

Bir bağımsız değişkenler listesindeki bir işaretçi kullanarak biçimlendirilmiş çıktı yaz.Bu işlevler daha güvenli sürümlerinin kullanılabilir olduğunu; see vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l.

int vsnprintf(
   char *buffer,
   size_t count,
   const char *format,
   va_list argptr 
);
int _vsnprintf(
   char *buffer,
   size_t count,
   const char *format,
   va_list argptr 
);
int _vsnprintf_l(
   char *buffer,
   size_t count,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vsnwprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr 
);
int _vsnwprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
template <size_t size>
int vsnprintf(
   char (&buffer)[size],
   size_t count,
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsnprintf(
   char (&buffer)[size],
   size_t count,
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsnprintf_l(
   char (&buffer)[size],
   size_t count,
   const char *format,
   locale_t locale,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsnwprintf(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsnwprintf_l(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
); // C++ only

Parametreler

buffer
Çıkış için depolama konumu.
count
Yazmak için karakter sayısı üst sınırı.
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,_vsnprintf, ve _vsnwprintf yazmak için karakter sayısına eşit veya daha az olup olmadığını yazılan karakterlerin sayısını count; yazmak için karakter sayısı büyükse count, bu işlevler dönüş -1 çıkış kesildi gösteren.Dönüş değeri bir yazılmışsa Sonlandırıcı boş yer almaz.

buffer Veya format olan NULL, ya da sayı sıfıra eşit veya daha az ise, bu işlevler geçersiz parametre işleyicisi açıklandığı şekilde harekete Parametre doğrulama.Yürütülmesine devam etmek için izin verilmişse, bu işlevler -1 geri dönün ve errno için EINVAL.

Notlar

Bu işlevlerden her biri için bir bağımsız değişken listesi bir işaretçi alır sonra veri biçimleri ve en çok yazar count için bellek karaktere işaret tarafından buffer.Sonunda yer yoksa (yani, yazmak için karakter sayısı ise daha az count), arabellek boş sonlandırılmış olacaktır.

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ğundan kesinlikle küçük olan ve null olarak işlev çağrılmadan önce arabelleğe başlatılamıyor.

vsnprintfaynıdır _vsnprintf.vsnprintfStandart ANSI uyumluluk için eklenmiştir; _vnsprintfgeriye dönük uyumluluk için korunur.

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

C++'da, bu işlevlerin daha yeni ve güvenli karşılıkları çağırmak şablon aşırı bu işlevleri vardır.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	_vsnprintf	_vsnprintf	_vsnwprintf
_vsntprintf_l	_vsnprintf_l	_vsnprintf_l	_vsnwprintf_l

Gereksinimler

Yordamı	Gerekli başlık	İsteğe bağlı üstbilgileri
vsnprintf	<stdio.h> ve <stdarg.h>	<varargs.h> *
_vsnprintf, _vsnprintf_l	<stdio.h> ve <stdarg.h>	<varargs.h> *
_vsnwprintf, _vsnwprintf_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.cpp
// compile with: /W3
#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( buff, sizeof(buff) - 1, formatstring, args); // C4996
// Note: vsnprintf is deprecated; consider vsnprintf_s instead
   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!!");
}