fprintf, _fprintf_l, fwprintf, _fwprintf_l

Makale
06/09/2015

Biçimlendirilmiş veri akışı için yazdırın.Bu işlevler daha güvenli sürümlerinin kullanılabilir olduğunu; see fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

int fprintf( 
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_l( 
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int fwprintf( 
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_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

fprintfyazılan bayt sayısını verir.fwprintfyazılan geniş karakter sayısını verir.Çıktı hatası oluştuğunda bu işlevlerden her biri negatif bir değer yerine döndürür.stream Veya format olan NULL, bu işlevler açıklandığı gibi geçersiz bir parametre işleyicisi çağırmak Parametre Doğrulama.Yürütülmesine devam etmek için izin verilirse, İşlevler -1 döndürür ve errno için EINVAL.Biçim dizesi için geçerli biçimlendirme karakterlerini denetlenmemiştir kullanırken olduğu gibi fprintf_s veya fwprintf_s.

Bkz: _doserrno, errno, _sys_errlist ve _sys_nerr bu ve diğer hata kodları hakkında daha fazla bilgi için.

Notlar

fprintfbiç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, format baðýmsýz deðiþkeni vardýr aynı sözdizimi ve sahip, kullanımı printf.

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

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

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

Genel metin yordamı eşlemeleri

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlı değil	Tanımlanan _mbcs	Tanımlanan _UNICODE
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

Daha fazla bilgi için bkz: Biçimi belirtimleri.

Gereksinimler

İşlev	Gerekli başlık
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> veya <wchar.h>

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

Örnek

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

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

FILE *stream;

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

   fopen_s( &stream, "fprintf.out", "w" );
   fprintf( stream, "%s%c", s, c );
   fprintf( stream, "%d\n", i );
   fprintf( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf.out" );
}