_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

Biçimlendirilmiş verileri bir akışa yazdırır.

Sözdizimi

int _fprintf_p(
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_p_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument ]...
);
int _fwprintf_p(
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_p_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument ]...
);

Parametreler

stream
Yapı işaretçisi FILE .

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

_fprintf_p yazın veya _fwprintf_p bir çıkış hatası oluştuğunda negatif bir değer döndürür.

Açıklamalar

_fprintf_p , çıkışına streambir dizi karakter ve değer biçimlendirip yazdırır. Her işlev argument (varsa) dönüştürülür ve içindeki formatilgili biçim belirtimine göre çıkış oluşturur. için _fprintf_p, bağımsız değişkeninin format içinde _printf_pbulunan söz dizimi ile aynı olur. Bu işlevler konumsal parametreleri destekler; yani biçim dizesi tarafından kullanılan parametrelerin sırası değiştirilebilir. Konumsal parametreler hakkında daha fazla bilgi için bkz . Printf_p Konumsal Parametreler.

_fwprintf_p, içinde öğesinin _fprintf_p_fwprintf_pformat geniş karakterli bir sürümüdür; geniş karakterli bir dizedir. Akış ANSI modunda açıldığında bu işlevler aynı şekilde davranır. _fprintf_p şu anda UNICODE akışına çıkışı desteklemez.

Bu işlevlerin sonekli _l sürümleri aynıdır, ancak geçerli 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.

Güvenli olmayan sürümler gibi (bkzfprintf. , _fprintf_l, fwprintf, _fwprintf_l), bu işlevler parametrelerini doğrular ve parametre doğrulamasında açıklandığı gibi, null bir işaretçiyse veya format boş bir işaretçiyse stream ya da bilinmeyen veya hatalı biçimlendirilmiş biçimlendirme tanımlayıcıları varsa geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, işlevler -1 döndürür ve olarak EINVALayarlanırerrno.

Genel metin yordamı 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.

tchar.h işlevi	_UNICODE ve _MBCS tanımlanmadı	_MBCS tanımlanan	_UNICODE tanımlanan
_ftprintf_p	_fprintf_p	_fprintf_p	_fwprintf_p
_ftprintf_p_l	_fprintf_p_l	_fprintf_p_l	_fwprintf_p_l

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

Gereksinimler

İşlev	Gerekli başlık
_fprintf_p, _fprintf_p_l	<stdio.h>
_fwprintf_p, _fwprintf_p_l	<stdio.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

// crt_fprintf_p.c
// This program uses _fprintf_p to format various
// data and print it to the file named FPRINTF_P.OUT. It
// then displays FPRINTF_P.OUT on the screen using the system
// function to invoke the operating-system TYPE command.
//

#include <stdio.h>
#include <process.h>

int main( void )
{
    FILE    *stream = NULL;
    int     i = 10;
    double  fp = 1.5;
    char    s[] = "this is a string";
    char    c = '\n';

    // Open the file
    if ( fopen_s( &stream, "fprintf_p.out", "w" ) == 0)
    {
        // Format and print data
        _fprintf_p( stream, "%2$s%1$c", c, s );
        _fprintf_p( stream, "%d\n", i );
        _fprintf_p( stream, "%f\n", fp );

        // Close the file
        fclose( stream );
    }

    // Verify our data
    system( "type fprintf_p.out" );
}

this is a string
10
1.500000

Ayrıca bkz.

Akış G/Ç
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, , __swprintf_l
printf_p Konumsal Parametreler
_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
printf_p Konumsal Parametreler
fscanf_s, _fscanf_s_l, fwscanf_s, _fwscanf_s_l