Condividi tramite

_vcprintf_p, _vcprintf_p_l, _vcwprintf_p_vcwprintf_p_l

  • Articolo

Scrive l'output formattato nella console usando un puntatore a un elenco di argomenti e supporta i parametri posizionali nella stringa di formato.

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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
);

Parametri

format
Specifica del formato.

argptr
Un puntatore a un elenco di argomenti.

locale
Impostazioni locali da usare.

Per altre informazioni, vedere Sintassi delle specifiche di formato: printf e wprintf funzioni.

Valore restituito

Il numero di caratteri che vengono scritti o un valore negativo se si verifica un errore di output. Se format è un puntatore Null, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, errno viene impostata su EINVALe viene restituito -1.

Osservazioni:

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi usa la funzione _putch per formattare e scrivere i dati specificati nella console. (_vcwprintf_p usa _putwch invece di _putch. _vcwprintf_p è la versione a caratteri wide di _vcprintf_p. Accetta una stringa di caratteri wide come argomento.

Le versioni di queste funzioni con il suffisso _l sono identiche, ad eccezione del fatto che usano il parametro delle impostazioni locali passato al posto delle impostazioni locali correnti.

Eventuali argument vengono convertiti ed emessi in base alla specifica del formato corrispondente in format. La specifica del formato supporta i parametri posizionali in modo da poter specificare l'ordine in cui gli argomenti vengono usati nella stringa di formato. Per altre informazioni, vedere printf_p Positional Parameters (Parametri posizionali printf_p).

Queste funzioni non convertono i caratteri di avanzamento riga nell'output in combinazioni di ritorno a capo (CR-LF).

Importante

Assicurarsi che format non sia una stringa definita dall'utente. Per altre informazioni, vedere Evitare sovraccarichi del buffer.

Queste funzioni convalidano il puntatore di input e la stringa di formato. Se format o argument è NULLo o se la stringa di formato contiene caratteri di formattazione non validi, queste funzioni richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono -1 e impostano errno su EINVAL.

Mapping di routine di testo generico

Routine Tchar.h _UNICODE e _MBCS non definito _MBCS definito _UNICODE definito
_vtcprintf_p _vcprintf_p _vcprintf_p _vcwprintf_p
_vtcprintf_p_l _vcprintf_p_l _vcprintf_p_l _vcwprintf_p_l

Requisiti

Ciclo Intestazione obbligatoria
_vcprintf_p, _vcprintf_p_l <conio.h> e <stdarg.h>
_vcwprintf_p, _vcwprintf_p_l <conio.h> e <stdarg.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Importante

A partire da Windows 10 versione 2004 (build 19041), la printf famiglia di funzioni stampa numeri a virgola mobile esattamente rappresentabili in base alle regole IEEE 754 per l'arrotondamento. Nelle versioni precedenti di Windows, i numeri a virgola mobile che terminano in '5' verrebbero sempre arrotondati. IEEE 754 indica che devono essere arrotondati alla cifra pari più vicina (nota anche come "Arrotondamento del banchiere"). Ad esempio, sia printf("%1.0f", 1.5) che printf("%1.0f", 2.5) devono essere arrotondati a 2. In precedenza, 1,5 arrotonderebbe a 2 e 2,5 arrotonderebbe a 3. Questa modifica influisce solo sui numeri rappresentabili esattamente. Ad esempio, 2.35 (che, se rappresentato in memoria, è più vicino a 2,350000000000000008) continua a arrotondare fino a 2,4. L'arrotondamento eseguito da queste funzioni ora rispetta anche la modalità di arrotondamento a virgola mobile impostata da fesetround. In precedenza, l'arrotondamento ha sempre scelto FE_TONEAREST il comportamento. Questa modifica interessa solo i programmi compilati con Visual Studio 2019 versione 16.2 e successive. Per usare il comportamento di arrotondamento a virgola mobile legacy, collegarsi a legacy_stdio_float_rounding.obj.

Esempio

// 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

Vedi anche

I/O della console e della porta
_cprintf, _cprintf_l, _cwprintf_cwprintf_l
va_arg, va_copy, va_endva_start
Parametri posizionali printf_p