vsnprintf_s, , _vsnprintf_s, _vsnprintf_s_l, , _vsnwprintf_s_vsnwprintf_s_l

Zapisz sformatowane dane wyjściowe przy użyciu wskaźnika do listy argumentów. Te funkcje są wersjami vsnprintf, _vsnprintf, , _vsnprintf_l, _vsnwprintfz _vsnwprintf_l ulepszeniami zabezpieczeń zgodnie z opisem w temacie Funkcje zabezpieczeń w CRT.

Składnia

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

Parametry

buffer
Miejsce przechowywania danych wyjściowych.

sizeOfBuffer
Rozmiar danych wyjściowych buffer for. Rozmiar w bajtach dla funkcji, które przyjmują char, i słowa dla tych, które przyjmują wchar_t.

count
Maksymalna liczba znaków do zapisania bez zakończenia NULL. W przypadku funkcji, które przyjmują wchar_t, jest to liczba szerokich znaków do napisania. Lub _TRUNCATE.

format
Specyfikacja formatu.

argptr
Wskaźnik do listy argumentów.

locale
Ustawienia regionalne, które mają być używane podczas formatowania danych wyjściowych.

Aby uzyskać więcej informacji, zobacz Specyfikacje formatu.

Wartość zwracana

Liczba zapisanych znaków, nie wliczając kończącego NULLlub wartości ujemnej, jeśli wystąpi błąd wyjściowy.

Aby uzyskać szczegółowe informacje, zobacz Podsumowanie zachowania.

Uwagi

Każda z tych funkcji pobiera wskaźnik do listy argumentów, a następnie formatuje i zapisuje do count znaków podanych danych w pamięci wskazywanej przez buffer i dołącza kończący NULL.

W kompilacjach debugowania pozostałe sizeOfBuffer bajty po zakończeniu NULL są wypełniane przez "xFE", jak opisano w _CrtSetDebugFillThreshold.

Wersje tych funkcji z sufiksem _l są identyczne, z tą różnicą, że używają parametru locale przekazanego zamiast bieżących ustawień regionalnych wątku.

vsnprintf_s jest identyczny i _vsnprintf_s uwzględniony w celu zapewnienia zgodności ze standardem ANSI. _vnsprintf jest zachowywany w celu zapewnienia zgodności z poprzednimi wersjami.

Podsumowanie zachowania

W poniższej tabeli:

• Pozwól len na rozmiar sformatowanych danych. Jeśli funkcja przyjmuje char bufor, rozmiar jest w bajtach. Jeśli funkcja przyjmuje wchar_t bufor, rozmiar określa liczbę 16-bitowych wyrazów.
• Znaki odwołują się do char znaków funkcji, które przyjmują char bufor, oraz do wchar_t znaków funkcji, które przyjmują wchar_t bufor.
• Aby uzyskać więcej informacji na temat nieprawidłowej procedury obsługi parametrów, zobacz Walidacja parametrów.

Aby uzyskać informacje o tych i innych kodach błędów, zobacz _doserrno, errno, _sys_errlisti _sys_nerr.

W języku C++ korzystanie z tych funkcji jest uproszczone przez przeciążenia szablonów; Przeciążenia mogą automatycznie wnioskować o długości buforu (eliminując konieczność określania argumentu rozmiaru) i mogą automatycznie zastępować starsze, niezabezpieczone funkcje nowszymi, bezpiecznymi odpowiednikami. Aby uzyskać więcej informacji, zobacz Bezpieczne przeciążenia szablonów.

Mapowania procedur tekstu ogólnego

Wymagania

* Wymagane do zapewnienia zgodności z systemem UNIX V.

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

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

Zobacz także

We/Wy strumienia
vprintf funkcjonalności
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