vsprintf_s, _vsprintf_s_l, vswprintf_s, , _vswprintf_s_l, _vstprintf_s, _vstprintf_s_l

Bir bağımsız değişken listesinin işaretçisini kullanarak biçimlendirilmiş çıktı yazın. Bu işlevler, _vsprintf_lCRT'dekivsprintf Güvenlik özellikleri bölümünde açıklandığı gibi güvenlik geliştirmelerine sahip , , _vswprintf_l'__vswprintf_l' sürümleridir. vswprintf

ve için _vstprintf_s bkz. Genel metin işlevi eşlemeleri_vstprintf_s_l.

Sözdizimi

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

Parametreler

buffer
Çıktı için depolama konumu.

numberOfElements
Karakter cinsinden boyutu buffer .

format
Biçim belirtimi.

argptr
Bağımsız değişken listesinin işaretçisi.

locale
Kullanılacak yerel ayar.

Dönüş değeri

vsprintf_s ve vswprintf_s sonlandırıcı null karakter veya bir çıkış hatası oluşursa negatif değer dahil olmak üzere yazılan karakter sayısını döndürebilirsiniz. veya buffer format null işaretçiyse, sıfırsa numberOfElements veya biçim dizesi geçersiz biçimlendirme karakterleri içeriyorsa, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, işlevler -1 döndürür ve olarak EINVALayarlanırerrno.

Bunlar ve diğer hata kodları hakkında bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

Bu işlevlerin her biri bir bağımsız değişken listesinin işaretçisini alır ve verilen verileri tarafından bufferişaret edilen belleğe biçimlendirip yazar.

vswprintf_s, türünde size_tikinci parametreyi countgerektiren için vswprintfISO C Standardına uygundur.

Bu işlevler, güvenli olmayan sürümlerden yalnızca güvenli sürümlerin konumsal parametreleri desteklemesinden farklıdır. Daha fazla bilgi için bkz printf_p . Konumsal Parametreler.

Bu işlevlerin sonekli _l sürümleri aynıdır, ancak geçerli iş parçacığı yerel ayarı yerine geçirilen yerel ayar parametresini kullanırlar.

C++'ta, bu işlevlerin kullanılması şablon aşırı yüklemeleriyle basitleştirilmiştir. Aşırı yüklemeler arabellek uzunluğunu otomatik olarak çıkararak boyut bağımsız değişkeni belirtme gereksinimini ortadan kaldırır. Ayrıca, güvenli olmayan işlevleri otomatik olarak güvenli karşılıklarıyla değiştirebilirler. Daha fazla bilgi için bkz . Güvenli şablon aşırı yüklemeleri.

Genel metin işlevi eşlemeleri

Sütundaki tchar.h işlev, derleme zamanında tanımlanan karakter kümesine bağlı olarak diğer sütunlardaki işlevle eşler.

Gereksinimler

* UNIX V uyumluluğu için gereklidir.

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

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

Ayrıca bkz.

Akış G/Ç
vprintf işlevleri
Biçim belirtimi söz dizimi: printf ve wprintf işlevleri
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_end, va_start