vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l

Articolo
03/05/2013

Scrivere l'output formattato utilizzando un puntatore a un elenco di argomenti.queste sono versioni di vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

int vsprintf_s(
   char *buffer,
   size_t numberOfElements,
   const char *format,
   va_list argptr 
); 
int _vsprintf_s_l(
   char *buffer,
   size_t numberOfElements,
   const char *format,
   locale_t locale,
   va_list argptr 
); 
int vswprintf_s(
   wchar_t *buffer,
   size_t numberOfElements,
   const wchar_t *format,
   va_list argptr 
);
int _vswprintf_s_l(
   wchar_t *buffer,
   size_t numberOfElements,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
template <size_t size>
int vsprintf_s(
   char (&buffer)[size],
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int vswprintf_s(
   wchar_t (&buffer)[size],
   const wchar_t *format,
   va_list argptr 
); // C++ only

Parametri

buffer
Percorso di archiviazione per l'output.
numberOfElements
dimensione di buffer i caratteri.
format
Specifica di formato.
argptr
Puntatore all'elenco degli argomenti.
locale
le impostazioni locali da utilizzare.

Valore restituito

vsprintf_s e vswprintf_s restituisce il numero di caratteri scritto, escluso il carattere di terminazione null, o un valore negativo se un errore di output si verifica.se buffer o format è un puntatore null, se il conteggio è zero, o se la stringa di formato contiene caratteri di formattazione non validi, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, le funzioni restituiscono -1 e impostate errno in EINVAL.

Per informazioni su questi e altri codici di errore, vedere _doserrno, errno, _sys_errlist e _sys_nerr.

Note

Ognuna di queste funzioni accetta un puntatore a un elenco di argomenti e quindi i formati e scrive i dati specificati a quella indicata da buffer.

vswprintf_s è conforme allo standard ISO C per vswprintf, che richiede il secondo parametro, count, di tipo size_t.

Queste funzioni differiscono solo nelle versioni non sicure in quanto le versioni sicure supportano i parametri posizionali.Per ulteriori informazioni, vedere parametri posizionali di printf_p.

le versioni di queste funzioni con _l il suffisso è identico con la differenza che utilizzano il parametro delle impostazioni locali passato alle impostazioni locali del thread corrente.

In C++, utilizzando queste funzioni è semplificato dagli overload del modello; gli overload possono dedurre la lunghezza del buffer automaticamente (che elimina la necessità di specificare un argomento di dimensione) e possono sostituire automaticamente le funzioni precedenti e non sicure con le più recenti, controparti sicure.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_vstprintf_s	vsprintf_s	vsprintf_s	vswprintf_s
_vstprintf_s_l	_vsprintf_s_l	_vsprintf_s_l	_vswprintf_s_l

Requisiti

routine	Intestazione di associazione	intestazioni facoltative
vsprintf_s, _vsprintf_s_l	<stdio.h> e <stdarg.h>	<varargs.h> *
vswprintf_s, _vswprintf_s_l	<stdio.h> o <wchar.h> e <stdarg.h>	<varargs.h> *

* Obbligatorio per la compatibilità dell'utilità UNIX V.

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

// crt_vsprintf_s.c
// This program uses vsprintf_s to write to a buffer.
// The size of the buffer is determined by _vscprintf.

#include <stdlib.h>
#include <stdarg.h>

void test( char * format, ... )
{
   va_list args;
   int len;
   char * buffer;

   va_start( args, format );
   len = _vscprintf( format, args ) // _vscprintf doesn't count
                               + 1; // terminating '\0'
   buffer = malloc( len * sizeof(char) );
   vsprintf_s( buffer, len, format, args );
   puts( buffer );
   free( buffer );
}

int main( void )
{
   test( "%d %c %d", 123, '<', 456 );
   test( "%s", "This is a string" );
}