vsprintf, , _vsprintf_l, vswprintf, , _vswprintf_l__vswprintf_l

Zapisz sformatowane dane wyjściowe przy użyciu wskaźnika do listy argumentów. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz vsprintf_s, , _vsprintf_s_lvswprintf_s, , _vswprintf_s_l.

Składnia

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

Parametry

buffer
Miejsce przechowywania danych wyjściowych.

count
Maksymalna liczba znaków do przechowywania w wersjach tej funkcji z szerokim ciągiem.

format
Specyfikacja formatu.

argptr
Wskaźnik do listy argumentów.

locale
Ustawienia regionalne, które mają być używane.

Wartość zwracana

vsprintf i vswprintf zwraca liczbę zapisanych znaków, nie wliczając znaku kończącego NULL , ani wartości ujemnej, jeśli wystąpi błąd wyjściowy. Jeśli buffer lub format jest wskaźnikiem NULL , te funkcje wywołują nieprawidłową procedurę obsługi parametrów, zgodnie z opisem w temacie Walidacja parametrów. Jeśli wykonywanie może być kontynuowane, te funkcje zwracają -1 i ustawiają errno wartość EINVAL.

Jeśli buffer jest wskaźnikiem NULL i count ma wartość zero, a vswprintf zwraca liczbę znaków, _vswprintf_l które zostałyby zapisane bez zakończenia NULL.

Jeśli buffer jest prawidłowa i count ma wartość zero, vswprintf a _vswprintf_l następnie zwraca wartość -1. Zawartość pozostaje buffer niezmieniona.

Aby uzyskać informacje na temat tych i innych kodów błędów, zobacz errno, _doserrno_sys_errlist, , i _sys_nerr.

Uwagi

Każda z tych funkcji pobiera wskaźnik do listy argumentów, a następnie formatuje i zapisuje podane dane w pamięci wskazywanej przez buffer.

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.

vswprintf jest zgodny z normą ISO C, która wymaga drugiego parametru, count, typu size_t. Aby wymusić stare, niestandardowe zachowanie, zdefiniuj _CRT_NON_CONFORMING_SWPRINTFS. Stare zachowanie może nie być w przyszłej wersji, więc kod powinien zostać zmieniony tak, aby używał nowego zgodnego zachowania.

W języku C++ te funkcje mają przeciążenia szablonów, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji. 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_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że

We/Wy strumienia
vprintf funkcjonalności
Składnia specyfikacji formatu: printf i wprintf funkcje
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