_vsprintf_p
, _vsprintf_p_l
, _vswprintf_p
, _vswprintf_p_l
Bağımsız değişkenlerin kullanıldığı sırayı belirtme özelliğiyle, bir bağımsız değişken listesinin işaretçisini kullanarak biçimlendirilmiş çıktı yazın.
Sözdizimi
int _vsprintf_p(
char *buffer,
size_t sizeInBytes,
const char *format,
va_list argptr
);
int _vsprintf_p_l(
char *buffer,
size_t sizeInBytes,
const char *format,
_locale_t locale,
va_list argptr
);
int _vswprintf_p(
wchar_t *buffer,
size_t count,
const wchar_t *format,
va_list argptr
);
int _vswprintf_p_l(
wchar_t *buffer,
size_t count,
const wchar_t *format,
_locale_t locale,
va_list argptr
);
Parametreler
buffer
Çıktı için depolama konumu.
sizeInBytes
Karakter cinsinden boyutu buffer
.
count
Bu işlevin UNICODE sürümünde saklanacak karakter sayısı üst sınırı.
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_p
ve _vswprintf_p
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.
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 buffer
işaret edilen belleğe biçimlendirip yazar.
Bu işlevler, ve'den vswprintf_s
yalnızca konumsal parametreleri desteklediğinden vsprintf_s
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.
buffer
veya format
parametreleri NULL
işaretçiyse, sayı sıfırsa veya biçim dizesi geçersiz biçimlendirme karakterleri içeriyorsa, parametre doğrulamasında 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 EINVAL
ayarlanırerrno
.
Önemli
Windows 10 sürüm 2004 'den (derleme 19041) printf
başlayarak, işlev ailesi yuvarlama için IEEE 754 kurallarına göre tam olarak temsil edilebilir kayan nokta numaraları yazdırır. Windows'un önceki sürümlerinde, '5' ile biten tam olarak temsil edilebilir kayan nokta sayıları her zaman yukarı yuvarlanırdı. IEEE 754, en yakın çift rakama ("Bankacı Yuvarlama" olarak da bilinir) yuvarlamaları gerektiğini belirtir. Örneğin, hem hem de printf("%1.0f", 1.5)
printf("%1.0f", 2.5)
2'ye yuvarlanmalıdır. Daha önce 1,5 2'ye, 2,5 ise 3'e yuvarlardı. Bu değişiklik yalnızca tam olarak temsil edilebilir sayıları etkiler. Örneğin, 2,35 (bellekte temsil edildiğinde 2,3500000000000000000008'e daha yakındır) 2,4'e kadar yuvarlanmaya devam eder. Bu işlevler tarafından yapılan yuvarlama artık tarafından fesetround
ayarlanan kayan nokta yuvarlama moduna da dikkat eder. Daha önce yuvarlama her zaman davranışı seçmişti FE_TONEAREST
. Bu değişiklik yalnızca Visual Studio 2019 sürüm 16.2 ve üzeri kullanılarak oluşturulan programları etkiler. Eski kayan nokta yuvarlama davranışını kullanmak için 'legacy_stdio_float_rounding.obj' ile bağlantı sağlayın.
Genel metin yordamı eşlemeleri
TCHAR.H yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_vstprintf_p |
_vsprintf_p |
_vsprintf_p |
_vswprintf_p |
_vstprintf_p_l |
_vsprintf_p_l |
_vsprintf_p_l |
_vswprintf_p_l |
Gereksinimler
Yordam | Gerekli başlık | İsteğe bağlı üst bilgiler |
---|---|---|
_vsprintf_p , _vsprintf_p_l |
<stdio.h> ve <stdarg.h> | <varargs.h>* |
_vswprintf_p , _vswprintf_p_l |
<stdio.h> veya <wchar.h> ve <stdarg.h> | <varargs.h>* |
* UNIX V uyumluluğu için gereklidir.
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Örnek
// crt__vsprintf_p.c
// This program uses vsprintf_p to write to a buffer.
// The size of the buffer is determined by _vscprintf_p.
#include <stdlib.h>
#include <stdio.h>
#include <stdarg.h>
void example( char * format, ... )
{
va_list args;
int len;
char *buffer = NULL;
va_start( args, format );
// _vscprintf doesn't count the
// null terminating string so we add 1.
len = _vscprintf_p( format, args ) + 1;
// Allocate memory for our buffer
buffer = (char*)malloc( len * sizeof(char) );
if (buffer)
{
_vsprintf_p( buffer, len, format, args );
puts( buffer );
free( buffer );
}
va_end( args );
}
int main( void )
{
// First example
example( "%2$d %1$c %3$d", '<', 123, 456 );
// Second example
example( "%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