vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, , , _vsnwprintf_s_vsnwprintf_s_l

Skriv formaterade utdata med en pekare till en lista med argument. Dessa funktioner är versioner av vsnprintf, _vsnprintf, _vsnprintf_l, _vsnwprintf_vsnwprintf_l , med säkerhetsförbättringar som beskrivs i Säkerhetsfunktioner i CRT.

Syntax

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

Parameterar

buffer
Lagringsplats för utdata.

sizeOfBuffer
Storleken på buffer för utdata. Storlek i byte för de funktioner som tar charoch ord för de som tar wchar_t.

count
Maximalt antal tecken som ska skrivas, exklusive avslutande NULL. För de funktioner som tar wchar_tär det antalet breda tecken som ska skrivas. Eller _TRUNCATE.

format
Specifikation av format.

argptr
Pekare till en lista med argument.

locale
Språket som ska användas när du formaterar utdata.

Mer information finns i Formatspecifikationer.

Returvärde

Antalet skrivna tecken, exklusive avslutande NULL, eller ett negativt värde om ett utdatafel inträffar.

Mer information finns i Beteendesammanfattning .

Anmärkningar

Var och en av dessa funktioner tar en pekare till en argumentlista, formaterar och skriver sedan upp till count tecken i de givna data till minnet som pekas på av buffer och lägger till en avslutande NULL.

I felsökningsbyggen fylls de återstående sizeOfBuffer byten som följer efter avslutningen NULL med "xFE" enligt beskrivningen i _CrtSetDebugFillThreshold.

Versionerna av dessa funktioner med suffixet _l är identiska, förutom att de använder parametern locale som skickas i stället för den aktuella trådspråkinställningen.

vsnprintf_s är identisk med _vsnprintf_s och ingår för överensstämmelse med ANSI-standarden. _vnsprintf behålls för bakåtkompatibilitet.

Beteendesammanfattning

För följande tabell:

• Låt vara len storleken på de formaterade data. Om funktionen tar en char buffert är storleken i byte. Om funktionen tar en wchar_t buffert anger storleken antalet 16-bitars ord.
• Tecken refererar till char tecken för funktioner som tar en char buffert och till wchar_t tecken för funktioner som tar en wchar_t buffert.
• Mer information om den ogiltiga parameterhanteraren finns i Parameterverifiering.

Information om dessa och andra felkoder finns i _doserrno, errno, _sys_errlistoch _sys_nerr.

I C++ förenklas användningen av dessa funktioner av överbelastningar av mallar; Överlagringarna kan härleda buffertlängden automatiskt (vilket eliminerar behovet av att ange ett storleksargument) och de kan automatiskt ersätta äldre, icke-säkra funktioner med sina nyare, säkra motsvarigheter. För mer information, se Secure template overloads.

Allmän textrutinmappning

Kravspecifikation

* Krävs för UNIX V-kompatibilitet.

Mer kompatibilitetsinformation finns i Kompatibilitet.

Exempel

// 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!

Se även

Stream I/O-
vprintf funktioner
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_endva_start