vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_lvsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_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. Bardziej bezpieczne wersje tych funkcji są dostępne; Zobacz vsprintf_s, _vsprintf_s_l, vswprintf_s _vswprintf_s_l.More secure versions of these functions are available; see vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l.

SkładniaSyntax

int vsprintf(
   char *buffer,
   const char *format,
   va_list argptr
);
int _vsprintf_l(
   char *buffer,
   const char *format,
   locale_t locale,
   va_list argptr
);
int vswprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr
);
int _vswprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr
);
int __vswprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   locale_t locale,
   va_list argptr
);
template <size_t size>
int vsprintf(
   char (&buffer)[size],
   const char *format,
   va_list argptr
); // C++ only
template <size_t size>
int _vsprintf_l(
   char (&buffer)[size],
   const char *format,
   locale_t locale,
   va_list argptr
); // C++ only
template <size_t size>
int vswprintf(
   wchar_t (&buffer)[size],
   const wchar_t *format,
   va_list argptr
); // C++ only
template <size_t size>
int _vswprintf_l(
   wchar_t (&buffer)[size],
   const wchar_t *format,
   locale_t locale,
   va_list argptr
); // C++ only

ParametryParameters

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

liczbącount
Maksymalna liczba znaków do zapisania w wersjach szerokiego ciągu tej funkcji.Maximum number of characters to store, in the wide string versions of this function.

Formatowanieformat
Specyfikacja formatu.Format specification.

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

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

Wartość zwracanaReturn Value

vsprintf i vswprintf zwracają liczbę znaków, bez uwzględnienia kończącego znaku null, lub wartość ujemną, jeśli wystąpi błąd danych wyjściowych.vsprintf and vswprintf 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, te funkcje wywołują procedurę obsługi nieprawidłowego parametru, zgodnie z opisem w walidacji parametru.If buffer or format is a null pointer, these functions invoke the invalid parameter handler, as described in Parameter Validation. Jeśli wykonanie może być kontynuowane, te funkcje zwracają wartość-1 i ustawiają errno na EINVAL.If execution is allowed to continue, these 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.

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.

Ważne

Korzystając z vsprintf, nie ma możliwości ograniczenia liczby pisanych znaków, co oznacza, że kod korzystający z tej funkcji jest podatny na przepełnienia buforu.Using vsprintf, there is no way to limit the number of characters written, which means that code using this function is susceptible to buffer overruns. Zamiast tego użyj _vsnprintf lub wywołaj _vscprintf , aby określić, jak duży bufor jest wymagany.Use _vsnprintf instead, or call _vscprintf to determine how large a buffer is needed. Upewnij się również, że Format nie jest ciągiem zdefiniowanym przez użytkownika.Also, ensure that format is not a user-defined string. Aby uzyskać więcej informacji, zobacz unikanie przekroczeń buforu.For more information, see Avoiding Buffer Overruns.

vswprintf jest zgodna ze standardem ISO C, który wymaga drugiego parametru, count, typu size_t.vswprintf conforms to the ISO C Standard, which requires the second parameter, count, of type size_t. Aby wymusić stare niestandardowe zachowanie, zdefiniuj _CRT_NON_CONFORMING_SWPRINTFS.To force the old nonstandard behavior, define _CRT_NON_CONFORMING_SWPRINTFS. Stare zachowanie może nie znajdować się w przyszłej wersji, dlatego należy zmienić kod, aby użyć nowego zachowania zgodnego.The old behavior may not be in a future version, so code should be changed to use the new conformant behavior.

W języku C++ te funkcje mają przeciążenia szablonu, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji.In C++, these functions have template overloads that invoke the newer, secure counterparts of these functions. 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_vstprintf vsprintfvsprintf vsprintfvsprintf vswprintfvswprintf
_vstprintf_l_vstprintf_l _vsprintf_l_vsprintf_l _vsprintf_l_vsprintf_l _vswprintf_l_vswprintf_l

WymaganiaRequirements

ProceduraRoutine Wymagany nagłówekRequired header Opcjonalne nagłówkiOptional headers
vsprintf, _vsprintf_lvsprintf, _vsprintf_l <stdio.h> i <stdarg.h><stdio.h> and <stdarg.h> <varargs.h>*
vswprintf, _vswprintf_lvswprintf, _vswprintf_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.c
// compile with: cl /W4 crt_vsprintf.c
// This program uses vsprintf to write to a buffer.
// The size of the buffer is determined by _vscprintf.

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

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

    // retrieve the variable arguments
    va_start( args, format );

    len = _vscprintf( format, args ) // _vscprintf doesn't count
                                + 1; // terminating '\0'

    buffer = (char*)malloc( len * sizeof(char) );
    if ( 0 != buffer )
    {
        vsprintf( buffer, format, args ); // C4996
        // Note: vsprintf is deprecated; consider using vsprintf_s instead
        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