_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l

Articolo
06/09/2015

Restituisce il numero di caratteri nella stringa formattata utilizzando un puntatore ad un elenco di argomenti, con la possibilità di specificare l'ordine in cui gli argomenti vengono utilizzati.

int _vscprintf_p(
   const char *format,
   va_list argptr 
);
int _vscprintf_p _l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_p _l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parametri

format
Stringa di controllo del formato.
argptr
Puntatore all'elenco di argomenti.
locale
Impostazioni locali da utilizzare.

Per ulteriori informazioni, vedere Specifiche di formato.

Valore restituito

_vscprintf_p restituisce il numero di caratteri che dovrebbero essere generati se la stringa puntata dalla lista di argomenti fosse stampata o inviata ad un file o buffer utilizzando i codici di formattazione specifici. Il valore restituito non include il carattere di terminazione null. _vscwprintf_p esegue la stessa funzione per i caratteri di tipo "wide".

Note

Queste funzioni differiscono da _vscprintf e _vscwprintf solo nel fatto che supportano la possibilità di specificare l'ordine in cui gli argomenti sono utilizzati. Per ulteriori informazioni, vedere Parametri posizionali printf_p.

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.

Se format è un puntatore a null, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce -1 e imposta errno a EINVAL.

Nota sulla sicurezza
Assicurarsi che se format è una stringa definita dall'utente, sia del tipo con terminazione null e con il corretto numero e tipo di parametri.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.