_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Biçimlendirilen dizedeki karakterlerin sayısını döndürür ve biçim dizesinde parametrelerin hangi sırada kullanılacağını belirtme olanağı sağlar.

Sözdizimi

int _scprintf_p(
   const char *format [,
   argument] ...
);
int _scprintf_p_l(
   const char *format,
   _locale_t locale [,
   argument] ...
);
int _scwprintf_p (
   const wchar_t *format [,
   argument] ...
);
int _scwprintf_p _l(
   const wchar_t *format,
   _locale_t locale [,
   argument] ...
);

Parametreler

format
Biçim denetimi dizesi.

argument
İsteğe bağlı bağımsız değişkenler.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Dizenin yazdırılması veya belirtilen biçimlendirme kodları kullanılarak bir dosyaya veya arabelleğe gönderilmesi durumunda oluşturulacak karakter sayısını döndürür. Döndürülen değer, sonlandırıcı null karakteri içermez. _scwprintf_p geniş karakterler için aynı işlevi gerçekleştirir.

ile _scprintf arasındaki _scprintf_p fark, _scprintf_p biçim dizesinde bağımsız değişkenlerin hangi sırada kullanılacağının belirtilmesine olanak tanıyan konumsal parametreleri desteklemesidir. Daha fazla bilgi için bkz . Printf_p Konumsal Parametreler.

bir işaretçiyseformat, parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.NULL Yürütmenin devam etmesi için izin verilirse, bu 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

Her argument biri (varsa) içindeki formatilgili biçim belirtimine göre dönüştürülür. Biçim sıradan karakterlerden oluşur ve için printfbağımsız değişkenle aynı biçime ve işleve format sahiptir.

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.

Önemli

format Kullanıcı tanımlı bir dize olmadığından emin olun.

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
_sctprintf_p	_scprintf_p	_scprintf_p	_scwprintf_p
_sctprintf_p_l	_scprintf_p_l	_scprintf_p_l	_scwprintf_p_l

Gereksinimler

Yordam	Gerekli başlık
_scprintf_p, _scprintf_p_l	<stdio.h>
_scwprintf_p, _scwprintf_p_l	<stdio.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Ayrıca bkz.

Akış G/Ç
_scprintf, _scprintf_l, _scwprintf, _scwprintf_l
_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l