_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l

Biçimlendirilmiş dizedeki karakter sayısını, bağımsız değişkenler listesinin işaretçisini kullanarak döndürür ve bağımsız değişkenlerin hangi sırada kullanılacağını belirtme olanağı sağlar.

Sözdizimi

int _vscprintf_p(
   const char *format,
   va_list argptr
);
int _vscprintf_p_l(
   const char *format,
   _locale_t locale,
   va_list argptr
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr
);
int _vscwprintf_p_l(
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

Parametreler

format
Biçim denetimi dizesi.

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

locale
Kullanılacak yerel ayar.

Daha fazla bilgi için bkz . Biçim belirtimi söz dizimi.

Dönüş değeri

_vscprintf_p , belirtilen biçimlendirme kodları kullanılarak bağımsız değişken listesinin işaret ettiği dize yazdırıldıysa veya bir dosyaya veya arabelleğe gönderildiyse, oluşturulacak karakter sayısını döndürür. Döndürülen değer, sonlandırıcı null karakteri içermez. _vscwprintf_p geniş karakterler için aynı işlevi gerçekleştirir.

Açıklamalar

Bu işlevler, bağımsız değişkenlerin hangi sırada kullanıldığını belirtme özelliğini desteklediğinden _vscprintf farklıdır ve _vscwprintf yalnızca bu işlevlerden 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.

Boş bir işaretçiyseformat, 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 EINVALayarlanırerrno.

Önemli

Kullanıcı tanımlı bir dizeyse format , null olarak sonlandırıldığına ve doğru parametre sayısına ve türüne sahip olduğundan emin olun. Daha fazla bilgi için bkz . Arabellek taşmalarından kaçınma. 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 fesetroundayarlanan 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
_vsctprintf_p	_vscprintf_p	_vscprintf_p	_vscwprintf_p
_vsctprintf_p_l	_vscprintf_p_l	_vscprintf_p_l	_vscwprintf_p_l

Gereksinimler

Yordam	Gerekli başlık
_vscprintf_p, _vscprintf_p_l	<stdio.h>
_vscwprintf_p, _vscwprintf_p_l	<stdio.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

örneğine vsprintfbakın.

Ayrıca bkz.

vprintf işlevleri
_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l
_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l