_fprintf_p
, _fprintf_p_l
, _ftprintf_p
, , _ftprintf_p_l
, _fwprintf_p
, _fwprintf_p_l
Biçimlendirilmiş verileri bir akışa yazdırır.
ve için _ftprintf_p
bkz. Genel metin işlevi eşlemeleri_ftprintf_p_l
.
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 stream
bir dizi karakter ve değer biçimlendirip yazdırır. Her işlev argument
(varsa) dönüştürülür ve içindeki format
ilgili biçim belirtimine göre çıkış oluşturur. için _fprintf_p
, bağımsız değişkeninin format
içinde _printf_p
bulunan 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_p
format
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 fesetround
ayarlanan 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 EINVAL
ayarlanırerrno
.
Genel metin işlevi 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