vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_lvsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l

Napisz sformatowane dane wyjściowe przy użyciu wskaźnika do listy argumentów.Write formatted output using a pointer to a list of arguments. Te funkcje są wersjami vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, _ _vswprintf_l z ulepszonymi zabezpieczeniami, zgodnie z opisem w temacie funkcje zabezpieczeń w CRT.These functions are versions of vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l with security enhancements as described in Security Features in the CRT.

SkładniaSyntax

int vsprintf_s(
   char *buffer,
   size_t numberOfElements,
   const char *format,
   va_list argptr
);
int _vsprintf_s_l(
   char *buffer,
   size_t numberOfElements,
   const char *format,
   locale_t locale,
   va_list argptr
);
int vswprintf_s(
   wchar_t *buffer,
   size_t numberOfElements,
   const wchar_t *format,
   va_list argptr
);
int _vswprintf_s_l(
   wchar_t *buffer,
   size_t numberOfElements,
   const wchar_t *format,
   locale_t locale,
   va_list argptr
);
template <size_t size>
int vsprintf_s(
   char (&buffer)[size],
   const char *format,
   va_list argptr
); // C++ only
template <size_t size>
int vswprintf_s(
   wchar_t (&buffer)[size],
   const wchar_t *format,
   va_list argptr
); // C++ only

ParametryParameters

buforubuffer
Lokalizacja magazynu dla danych wyjściowych.Storage location for output.

numberOfElementsnumberOfElements
Rozmiar buforu w znakach.Size of buffer in characters.

Formatowanieformat
Specyfikacja formatu.Format specification.

argptrargptr
Wskaźnik na listę argumentów.Pointer to list of arguments.

localelocale
Ustawienia regionalne do użycia.The locale to use.

Wartość zwracanaReturn Value

vsprintf_s i vswprintf_s zwracają liczbę pisanych znaków, bez uwzględnienia kończącego znaku null, lub wartość ujemną, jeśli wystąpi błąd danych wyjściowych.vsprintf_s and vswprintf_s return the number of characters written, not including the terminating null character, or a negative value if an output error occurs. Jeśli bufor lub Format jest wskaźnikiem o wartości null, jeśli NumberOfElements ma wartość zero lub jeśli ciąg formatu zawiera nieprawidłowe znaki formatowania, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w walidacji parametru.If buffer or format is a null pointer, if numberOfElements is zero, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in Parameter Validation. Jeśli wykonanie może być kontynuowane, funkcje zwracają wartość-1 i ustawiają errno na EINVAL.If execution is allowed to continue, the functions return -1 and set errno to EINVAL.

Aby uzyskać informacje o tych i innych kodach błędów, zobacz _doserrno, errno, _sys_errlist i _sys_nerr.For information on these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

UwagiRemarks

Każda z tych funkcji Pobiera wskaźnik do listy argumentów, a następnie formatuje i zapisuje dane w pamięci wskazywanej przez bufor.Each of these functions takes a pointer to an argument list, and then formats and writes the given data to the memory pointed to by buffer.

vswprintf_s jest zgodna ze standardem ISO C dla vswprintf, który wymaga drugiego parametru, Count typu size_t.vswprintf_s conforms to the ISO C Standard for vswprintf, which requires the second parameter, count, of type size_t.

Funkcje te różnią się od wersji niezabezpieczonej tylko w przypadku, gdy bezpieczne wersje obsługują parametry pozycyjne.These functions differ from the non-secure versions only in that the secure versions support positional parameters. Aby uzyskać więcej informacji, zobacz Printf_p parametry pozycyjne.For more information, see printf_p Positional Parameters.

Wersje tych funkcji z sufiksem _l są identyczne, z tą różnicą, że korzystają z przekazaną parametrem ustawień regionalnych zamiast bieżących ustawień regionalnych wątku.The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current thread locale.

W języku C++ korzystanie z tych funkcji jest uproszczone przez przeciążenia szablonów.In C++, using these functions is simplified by template overloads. Przeciążenia mogą automatycznie wywnioskować długość buforu, eliminując konieczność określenia argumentu rozmiaru.The overloads can infer buffer length automatically, eliminating the need to specify a size argument. Ponadto mogą automatycznie zamieniać niezabezpieczone funkcje z ich bezpiecznymi odpowiednikami.And, they can automatically replace non-secure functions with their secure counterparts. Aby uzyskać więcej informacji, zobacz bezpieczne przeciążenia szablonów.For more information, see Secure Template Overloads.

Mapowania procedur zwykłego tekstuGeneric-Text Routine Mappings

Procedura TCHAR.HTCHAR.H routine Nie zdefiniowano _MBCS _UNICODE &_UNICODE & _MBCS not defined _MBCS zdefiniowano_MBCS defined _UNICODE zdefiniowano_UNICODE defined
_vstprintf_s_vstprintf_s vsprintf_svsprintf_s vsprintf_svsprintf_s vswprintf_svswprintf_s
_vstprintf_s_l_vstprintf_s_l _vsprintf_s_l_vsprintf_s_l _vsprintf_s_l_vsprintf_s_l _vswprintf_s_l_vswprintf_s_l

WymaganiaRequirements

ProceduraRoutine Wymagany nagłówekRequired header Opcjonalne nagłówkiOptional headers
vsprintf_s, _vsprintf_s_lvsprintf_s, _vsprintf_s_l <stdio.h> i <stdarg.h><stdio.h> and <stdarg.h> <varargs.h>*
vswprintf_s, _vswprintf_s_lvswprintf_s, _vswprintf_s_l <stdio.h> lub <wchar.h> , i <stdarg.h><stdio.h> or <wchar.h>, and <stdarg.h> <varargs.h>*

* Wymagane w przypadku zgodności z systemem UNIX V.* Required for UNIX V compatibility.

Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodność.For additional compatibility information, see Compatibility.

PrzykładExample

// crt_vsprintf_s.c
// Compile with: cl /W4 crt_vsprintf_s.c
// This program uses vsprintf_s to write to a buffer.
// The size of the buffer is determined by _vscprintf.

#include <stdlib.h>
#include <stdio.h>
#include <stdarg.h>

void test( char const * const format, ... )
{
   va_list args;
   int len;
   char * buffer;

   va_start( args, format );
   len = _vscprintf( format, args ) // _vscprintf doesn't count
                               + 1; // terminating '\0'
   buffer = (char *) malloc( len * sizeof(char) );
   if ( NULL != buffer )
   {
      vsprintf_s( buffer, len, format, args );
      puts( buffer );
      free( buffer );
   }
   va_end( args );
}

int main( void )
{
   test( "%d %c %d", 123, '<', 456 );
   test( "%s", "This is a string" );
}
123 < 456
This is a string

Zobacz takżeSee also

We/Wy strumieniaStream I/O
Funkcje vprintf —vprintf Functions
Składnia specyfikacji formatu: funkcje printf i wprintfFormat Specification Syntax: printf and wprintf Functions
fprintf, _fprintf_l, fwprintf, _fwprintf_lfprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_lprintf, _printf_l, wprintf, _wprintf_l
sprintf —, _sprintf_l, swprintf, _swprintf_l, _ _swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
va_arg, va_copy, va_end, va_startva_arg, va_copy, va_end, va_start