_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

Makale
06/09/2015

Baskı veri akışı için biçimlendirilmiş.

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
İşaretçi FILE yapısı.
format
Denetim biçim dizesi.
argument
İsteğe bağlı bağımsız değişkenler.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

_fprintf_pve _fwprintf_p yazılan karakterlerin sayısını döndürmek veya çıktı hatası oluştuğunda, negatif bir değer döndürür.

Notlar

_fprintf_pbiçimleri ve bir dizi karakter ve çıktı değerleri yazdırır stream.Her işlev argument (varsa) dönüştürülür ve ilgili biçim belirtimini uyarınca çıktı format.İçin _fprintf_p, format baðýmsýz deðiþkeni vardýr aynı sözdizimi ve sahip, kullanımı _printf_p.Bu işlevler sırası biçim dizesi tarafından kullanılan parametreler değiştirilebilir anlamı Konumsal parametreleri destekler.Konumsal parametreler hakkında daha fazla bilgi için bkz: printf_p Konumsal Parametreler.

_fwprintf_pgeniş karakter sürümü _fprintf_p; de _fwprintf_p, format bir geniş karakter dizesidir.Akış ANSI modunda açılırsa bu işlevler aynı şekilde davranır._fprintf_pşu anda çıktı bir UNICODE akımına desteklemiyor.

Bu işlevler ile sürümlerini _l soneki yerine yerel geçirilen yerel parametresi kullandıkları dışında aynı.

Güvenlik Notu
Emin format kullanıcı tanımlı bir dize değil.

Güvenli olmayan sürümleri gibi (bkz: fprintf, _fprintf_l, fwprintf, _fwprintf_l), bu işlevler kendi parametrelerini doğrulamak ve açıklandığı gibi geçersiz bir parametre işleyicisi çağırmak Parametre Doğrulama, ya da, stream veya format bir null işaretçi veya bilinmeyen veya hatalı oluşturulmuş herhangi bir biçimlendirme belirticileri varsa.Yürütülmesine devam etmek için izin verilirse, İşlevler -1 döndürür ve errno için EINVAL.

Genel metin yordamı eşlemeleri

Tchar.h yordamına girildi	_UNICODE ve _mbcs tanımlı değil	Tanımlanan _mbcs	Tanımlanan _UNICODE
_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çimi belirtimleri.

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 bilgileri için bkz: Uyumluluk giriş.

Ö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" );
}