vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l
Bağımsız değişkenler listesi için bir işaretçi kullanarak biçimlendirilmiş çıktı yazma.Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l.
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
Parametreler
buffer
Çıktı için depolama konumu.count
Buna depolamak için karakter sayısı üst sınırı UNICODE bu işlev sürümü.format
Biçim belirtimi.argptr
Bağımsız değişkenler listesine işaretçi.locale
Kullanılacak yerel ayar.
Dönüş Değeri
vsprintf ve vswprintf sondaki null karakter dışında, harici bir hata oluştuğunda negatif bir değeri veya yazılmış karakterlerin sayısını döndürür.Yoksa buffer veya format bir null işaretçi açıklandığı gibi bu işlevleri geçersiz parametre işleyicisi çağırmak Parametre Doğrulama.Yürütmenin devam etmesine izin verilirse, bu işlevler -1 döndürür ve errno öğesini EINVAL olarak ayarlar.
Bunlar ve diğer hata kodları hakkında daha fazla bilgi için bkz. _doserrno, errno, _sys_errlist ve _sys_nerr.
Notlar
Bu işlevlerden her biri bir bağımsız değişken listesi için bir işaretçi alır ve sonra biçimlendirir ve verilen veri tarafından işaret bellek Yazar buffer.
_l sonekine sahip bu işlevlerin sürümleri, geçerli iş parçacığı yerel ayarı yerine iletilen yerel ayar parametresini kullanmalarıdır.
Güvenlik Notu |
---|
Kullanarak vsprintf, burada karakter sayısını sınırlamak için bir yol, bu işlevi kullanarak kod arabellek taşmaları getiriyor anlamına gelir yazılır.Kullanım _vsnprintf bunun yerine, ya da çağrı _vscprintf ne kadar büyük bir arabellek gerekli belirlemek için.Ayrıca, format öğesinin bir kullanıcı tanımlı dize olmadığından emin olun.Daha fazla bilgi için, bkz. Arabellek Taşmalarını Önleme. |
vswprintf, size_t türünden count ikinci parametresini gerektiren ISO C Standardı'na uygundur.Eski standart dışı davranışı zorlamak için tanımladığınız _CRT_NON_CONFORMING_SWPRINTFS. eski davranışı yeni uyumlu davranış kullanmak için kodu değişti şekilde gelecekteki bir sürümde olmayabilir.
C++ dilinde, bu işlevlerin daha yeni ve güvenli karşıtlarını başlatan şablon aşırı yüklemeleri vardır.Daha fazla bilgi için bkz. Güvenli Şablon Aşırı Yüklemeleri.
Genel Metin Yordam Eşleşmeleri
TCHAR.H yordamı |
_UNICODE & _MBCS tanımlanmamış |
_MBCS tanımlanmış |
_UNICODE tanımlanmış |
---|---|---|---|
_vstprintf |
vsprintf |
vsprintf |
vswprintf |
_vstprintf_l |
_vsprintf_l |
_vsprintf_l |
_vswprintf_l |
Gereksinimler
Yordam |
Gerekli başlık |
İsteğe bağlı üst bilgiler |
---|---|---|
vsprintf, _vsprintf_l |
<stdio.h> ve <stdarg.h> |
<varargs.h>* |
vswprintf, _vswprintf_l |
<stdio.h> veya <wchar.h> ve <stdarg.h> |
<varargs.h>* |
* UNIX V uyumluluğu için gerekli.
Ek uyumluluk bilgileri için Giriş altındaki Uyumluluk bölümüne bakın.
Örnek
// crt_vsprintf.c
// compile with: /W3
// This program uses vsprintf 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 * 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) );
vsprintf( buffer, format, args ); // C4996
// Note: vsprintf is deprecated; consider using vsprintf_s instead
puts( buffer );
free( buffer );
}
int main( void )
{
test( "%d %c %d", 123, '<', 456 );
test( "%s", "This is a string" );
}
.NET Framework Eşdeğeri
Ayrıca bkz.
Başvuru
Biçim Belirtim Sözdizimi: printf ve wprintf İşlevleri
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l