_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l

Bağımsız değişkenler listesi için bir işaretçi kullanarak biçimlendirilmiş çıkışı konsola yazar ve Biçim dizesinde konumsal parametrelerini destekler.

Önemli
Bu API Windows Çalışma Zamanı, içinde yürütülen uygulamalarda kullanılmaz.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

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şkenler listesi için bir işaretçi.

• locale
  Kullanılacak yerel ayar.

Daha fazla bilgi için bkz. Biçim Belirtim Sözdizimi: printf ve wprintf İşlevleri.

Dönüş Değeri

Yazılan karakter sayısını veya bir çıktı hatası oluşursa, negatif bir değer.format bir null işaretçiyse, Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.Yürütmenin devam etmesine izin verilirse, errno öğesi EINVAL olarak ayarlanır ve -1 döndürülür.

Notlar

Bu işlevlerden her biri bağımsız değişken listesi için bir işaretçi alır ve kullanır _putch format ve verilen veri konsola yazmak için işlev. (_vcwprintf_p uses _putwch instead of _putch._vcwprintf_p_vcprintf_p öğesinin geniş karakterli sürümüdür.Bu bir geniş karakter dize bağımsız değişken olarak alır.)

_l sonekine sahip bu işlevlerin sürümleri, geçerli yerel ayarı yerine iletilen yerel ayar parametresini kullanmalarıdır.

Her argument (varsa) dönüştürülür ve çıktının ilgili biçim belirtiminize göre format.Biçim dizesi bağımsız değişkenleri kullanılacağı sırayı belirtmek için biçim belirtimini konumsal parametrelerini destekler.Daha fazla bilgi için bkz. printf_p Konumsal Parametreler.

Çıkış olduklarında bu işlevler satır besleme karakterleri satır başı satır besleme (CR-LF) birleşimleri çevirmek değil.

Güvenlik Notu
format öğesinin bir kullanıcı tanımlı dize olmadığından emin olun.Daha fazla bilgi için, bkz. Arabellek Taşmalarını Önleme.

Bu işlevler, Giriş işaretçisi ve biçim dizesi doğrulayın.Varsa format veya argument olan NULL, ya da biçim dizesi geçersiz biçimlendirme karakteri içeriyorsa, bu işlevleri geçersiz parametre işleyicisi açıklandığı şekilde harekete geçirmek Parametre Doğrulama.Yürütmenin devam etmesine izin verilirse, bu işlevler -1 döndürür ve errno öğesini EINVAL olarak ayarlar.

Genel Metin Yordam Eşleşmeleri

Gereksinimler

Uyumluluk hakkında daha fazla bilgi için bkz. Uyumluluk.

Ö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);
  return _vcprintf_p(format, args);
}

int main()
{
   int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
      "one", 222);
   _cprintf_s("%d characters printed\r\n");
}

Ayrıca bkz.

Başvuru

Konsol ve Bağlantı Noktası G/Ç

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

va_arg, va_copy, va_end, va_start

printf_p Konumsal Parametreler