_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Articolo
03/05/2013

Restituisce il numero di caratteri nella stringa formattata utilizzando un puntatore ad una lista di argomenti.

int _vscprintf(
   const char *format,
   va_list argptr 
);
int _vscprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parametri

format
Stringa di formato e di controllo.
argptr
Puntatore all'elenco di argomenti.
locale
Le impostazioni locali da utilizzare.

Per ulteriori informazioni, vedere Specifiche di formato.

Valore restituito

_vscprintf 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 esegue la stessa funzione per i caratteri di tipo "wide".

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione che utilizzano il parametro delle impostazioni locali passato in ingresso invece di utilizzare 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.

Note

Ogni argument (se presente) viene convertito in base alla tipo di formato specificato in format.Il formato è costituito da caratteri normali e ha lo stesso form e la stessa funzione dell'argomento format per la funzione printf.

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.