_vcprintf_p
, _vcprintf_p_l
, _vcwprintf_p
, _vcwprintf_p_l
Bağımsız değişken listesinin işaretçisini kullanarak biçimlendirilmiş çıkışı konsola yazar ve biçim dizesindeki konumsal parametreleri destekler.
Önemli
Bu API, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.
Sözdizimi
int _vcprintf_p(
const char* format,
va_list argptr
);
int _vcprintf_p_l(
const char* format,
_locale_t locale,
va_list argptr
);
int _vcwprintf_p(
const wchar_t* format,
va_list argptr
);
int _vcwprintf_p_l(
const wchar_t* format,
_locale_t locale,
va_list argptr
);
Parametreler
format
Biçim belirtimi.
argptr
Bağımsız değişken listesinin işaretçisi.
locale
Kullanılacak yerel ayar.
Daha fazla bilgi için bkz . Biçim belirtimi söz dizimi: printf
ve wprintf
işlevleri.
Dönüş değeri
Yazılan karakter sayısı veya çıkış hatası oluşursa negatif bir değer. Boş bir işaretçiyseformat
, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, errno
olarak ayarlanır EINVAL
ve -1 döndürülür.
Açıklamalar
Bu işlevlerin her biri bir bağımsız değişken listesinin işaretçisini alır ve ardından verilen verileri biçimlendirmek ve konsola yazmak için işlevini kullanır _putch
. (_vcwprintf_p
yerine _putch
kullanır_putwch
, _vcwprintf_p
geniş karakterli sürümüdür_vcprintf_p
. Bağımsız değişken olarak geniş karakterli bir dize alır.)
Bu işlevlerin son ekine _l
sahip sürümleri, geçerli yerel ayar yerine geçirilen yerel ayar parametresini kullanmaları dışında aynıdır.
Her argument
(varsa) dönüştürülür ve içindeki format
ilgili biçim belirtimine göre çıkıştır. Biçim belirtimi, biçim dizesinde bağımsız değişkenlerin hangi sırada kullanılacağını belirtebilmeniz için konumsal parametreleri destekler. Daha fazla bilgi için bkz . Printf_p Konumsal Parametreler.
Bu işlevler çıktıdaki satır besleme karakterlerini satır başı besleme (CR-LF) birleşimlerine çevirmez.
Önemli
format
Kullanıcı tanımlı bir dize olmadığından emin olun. Daha fazla bilgi için bkz . Arabellek taşmalarından kaçınma.
Bu işlevler giriş işaretçisini ve biçim dizesini doğrular. veya format
argument
ise NULL
ya da biçim dizesi geçersiz biçimlendirme karakterleri içeriyorsa, bu işlevler Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, bu işlevler -1 döndürür ve olarak EINVAL
ayarlanırerrno
.
Genel metin yordamı eşlemeleri
Tchar.h yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS Tanımlanan |
_UNICODE Tanımlanan |
---|---|---|---|
_vtcprintf_p |
_vcprintf_p |
_vcprintf_p |
_vcwprintf_p |
_vtcprintf_p_l |
_vcprintf_p_l |
_vcprintf_p_l |
_vcwprintf_p_l |
Gereksinimler
Yordam | Gerekli başlık |
---|---|
_vcprintf_p , _vcprintf_p_l |
<conio.h> ve <stdarg.h> |
_vcwprintf_p , _vcwprintf_p_l |
<conio.h> ve <stdarg.h> |
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Önemli
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 ile legacy_stdio_float_rounding.obj
bağlayın.
Örnek
// crt_vcprintf_p.c
// compile with: /c
#include <conio.h>
#include <stdarg.h>
// An error formatting function that's used to print to the console.
int eprintf(const char* format, ...)
{
va_list args;
va_start(args, format);
int result = _vcprintf_p(format, args);
va_end(args);
return result;
}
int main()
{
int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
"one", 222);
_cprintf_s("%d characters printed\r\n");
}
parameter 2 = 222; parameter 1 = one
38 characters printed
Ayrıca bkz.
Konsol ve bağlantı noktası G/Ç
_cprintf
, _cprintf_l
, _cwprintf
, _cwprintf_l
va_arg
, va_copy
, va_end
, va_start
printf_p Konumsal Parametreler
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin