_vprintf_p, _vprintf_p_l, _vwprintf_p_vwprintf_p_l

  • Articolo

Scrive l'output formattato usando un puntatore a un elenco di argomenti e consente di specificare l'ordine in cui usare gli argomenti.

Sintassi

int _vprintf_p(
   const char *format,
   va_list argptr
);
int _vprintf_p_l(
   const char *format,
   _locale_t locale,
   va_list argptr
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr
);
int _vwprintf_p_l(
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

Parametri

format
Specifica di formato.

argptr
Puntatore a un elenco di argomenti.

locale
Impostazioni locali da usare.

Per altre informazioni, vedere Sintassi delle specifiche di formato.

Valore restituito

_vprintf_p e _vwprintf_p restituiscono il numero di caratteri scritti, escludendo il carattere Null di terminazione, o un valore negativo se si verifica un errore di output.

Osservazioni:

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti, quindi formatta e scrive i dati specificati in stdout. Queste funzioni differiscono da vprintf_s e vwprintf_s solo per il fatto che supportano la possibilità di specificare l'ordine in cui vengono usati gli argomenti. Per altre informazioni, vedere printf_p Positional Parameters (Parametri posizionali printf_p).

_vwprintf_p è la versione a caratteri wide di _vprintf_p; se il flusso viene aperto in modalità ANSI, le due funzioni si comportano in modo identico. _vprintf_p non supporta attualmente l'output in un flusso UNICODE.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione per il fatto che utilizzano il parametro delle impostazioni locali passato al posto di quelle del thread corrente.

Importante

Assicurarsi che format non sia una stringa definita dall'utente. Per altre informazioni, vedere Evitare sovraccarichi del buffer. 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".

Se format è un puntatore Null o se la stringa di formato contiene caratteri di formattazione non validi, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, le funzioni restituiranno -1 e imposteranno errno su EINVAL.

Mapping di routine di testo generico

Routine TCHAR.H _UNICODE e _MBCS non definito _MBCS definito _UNICODE definito
_vtprintf_p _vprintf_p _vprintf_p _vwprintf_p
_vtprintf_p_l _vprintf_p_l _vprintf_p_l _vwprintf_p_l

Requisiti

Ciclo Intestazione obbligatoria Intestazioni facoltative
_vprintf_p, _vprintf_p_l <stdio.h> e <stdarg.h> <varargs.h>*
_vwprintf_p, _vwprintf_p_l <stdio.h> o <wchar.h> e <stdarg.h> <varargs.h>*

* Obbligatorio per la compatibilità di UNIX V.

La console non è supportata nelle app piattaforma UWP (Universal Windows Platform) (UWP). Gli handle di flusso standard associati alla console, stdin, stdoute stderrdevono essere reindirizzati prima che le funzioni di runtime C possano usarle nelle app UWP. Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

I/O di flusso
Funzioni vprintf
_fprintf_p, _fprintf_p_l, _fwprintf_p_fwprintf_p_l
_printf_p, _printf_p_l, _wprintf_p_wprintf_p_l
_sprintf_p, _sprintf_p_l, _swprintf_p_swprintf_p_l
vsprintf_s, _vsprintf_s_l, vswprintf_s_vswprintf_s_l
va_arg, va_copy, va_endva_start
_vfprintf_p, _vfprintf_p_l, _vfwprintf_p_vfwprintf_p_l
_printf_p, _printf_p_l, _wprintf_p_wprintf_p_l
Parametri posizionali printf_p