vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l

Artigo
02/25/2013

Grave a saída formatada usando um ponteiro para uma lista de argumentos.Versões mais seguras dessas funções estão disponíveis; see vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l.

int vsprintf(
   char *buffer,
   const char *format,
   va_list argptr 
); 
int _vsprintf_l(
   char *buffer,
   const char *format,
   locale_t locale,
   va_list argptr 
); 
int vswprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr 
);
int _vswprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
int __vswprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
template <size_t size>
int vsprintf(
   char (&buffer)[size],
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsprintf_l(
   char (&buffer)[size],
   const char *format,
   locale_t locale,
   va_list argptr 
); // C++ only
template <size_t size>
int vswprintf(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vswprintf_l(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
); // C++ only

Parâmetros

buffer
Local de armazenamento para saída.
count
Número máximo de caracteres para armazenar, o UNICODE versão desta função.
format
Especificação de formato.
argptr
Ponteiro para a lista de argumentos.
locale
A localidade para usar.

Valor de retorno

vsprintfe vswprintf retornar o número de caracteres gravados, não incluindo o caractere nulo de terminação ou um valor negativo se ocorrer um erro de saída.Se buffer ou format é um ponteiro nulo, essas funções para chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essas funções retornam -1 e defina errno para EINVAL.

Para obter informações sobre estes e outros códigos de erro, consulte _doserrno, errno, _sys_errlist e _sys_nerr.

Comentários

Cada uma dessas funções e leva um ponteiro para uma lista de argumentos, em seguida, formata e grava os dados fornecidos à memória apontada por buffer.

As versões dessas funções com o _l sufixo são idênticas exceto que eles usam o parâmetro de localidade passado em vez da localidade do thread atual.

Observação de segurança
Usando vsprintf, aqui é há como limitar o número de caracteres gravado, que significa que o código usando essa função é suscetível a estouros de buffer.Use _vsnprintf em vez disso, ou ligue para _vscprintf para determinar o tamanho que um buffer é necessária.Além disso, certifique-se de que format não é uma seqüência definida pelo usuário.Para obter mais informações, consulte Evitando saturações de Buffer.

Usando vsprintf, aqui é há como limitar o número de caracteres gravado, que significa que o código usando essa função é suscetível a estouros de buffer.Use _vsnprintf em vez disso, ou ligue para _vscprintf para determinar o tamanho que um buffer é necessária.Além disso, certifique-se de que format não é uma seqüência definida pelo usuário.Para obter mais informações, consulte Evitando saturações de Buffer.

vswprintfestá de acordo com o ISO C padrão, que requer o segundo parâmetro, count, do tipo size_t.Para forçar o antigo comportamento diferente do padrão, definir _CRT_NON_CONFORMING_SWPRINTFS. o comportamento antigo não esteja em uma versão futura, portanto, o código deve ser alterado para usar o novo comportamento conformes.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_vstprintf	vsprintf	vsprintf	vswprintf
_vstprintf_l	_vsprintf_l	_vsprintf_l	_vswprintf_l

Requisitos

Rotina	Cabeçalho necessário	Cabeçalhos opcionais
vsprintf, _vsprintf_l	<stdio.h> e <stdarg.h>	<varargs.h> *
vswprintf, _vswprintf_l	<stdio.h> ou <wchar.h> e <stdarg.h>	<varargs.h> *

* Necessário para compatibilidade de UNIX V.

Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Exemplo

// crt_vsprintf.c
// compile with: /W3
// This program uses vsprintf to write to a buffer.
// The size of the buffer is determined by _vscprintf.

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

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

    // retrieve the variable arguments
    va_start( args, format );
    
    len = _vscprintf( format, args ) // _vscprintf doesn't count
                                + 1; // terminating '\0'
    
    buffer = (char*)malloc( len * sizeof(char) );

    vsprintf( buffer, format, args ); // C4996
    // Note: vsprintf is deprecated; consider using vsprintf_s instead
    puts( buffer );

    free( buffer );
}

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