Funções vprintf

  • Artigo

Cada uma das funções do vprintf usa um ponteiro para uma lista de argumentos e então formata e grava os dados determinados em um destino em particular. As funções diferem de várias maneiras: na validação de parâmetros, se as funções usam cadeias de caracteres de byte único ou largas, o destino de saída e o suporte para especificar os parâmetros de ordem são usados na cadeia de caracteres de formato.

_vcprintf, _vcwprintf
vfprintf, vfwprintf
_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l
vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l
vprintf, vwprintf
_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l
vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l
_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l
_vsnprintf, _vsnwprintfvsprintf, vswprintf
_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l
vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l

Comentários

As funções vprintf são semelhantes às funções correspondentes, conforme listado na tabela a seguir. No entanto, cada função vprintf aceita um ponteiro para uma lista de argumentos, enquanto cada uma das funções equivalentes aceita uma lista de argumentos.

Essas funções formatam os dados de saída para destinos como os seguintes.

Função Função equivalente Destino de saída Validação de parâmetro Suporte a parâmetros posicionais
_vcprintf _cprintf console Verifique se há nulos. não
_vcwprintf _cwprintf console Verifique se há nulos. não
vfprintf fprintf stream Verifique se há nulos. não
vfprintf_p fprintf_p stream Verifique se há nulos e formato válido. sim
vfprintf_s fprintf_s stream Verifique se há nulos e formato válido. não
vfwprintf fwprintf stream Verifique se há nulos. não
vfwprintf_p fwprintf_p stream Verifique se há nulos e formato válido. sim
vfwprintf_s fwprintf_s stream Verifique se há nulos e formato válido. não
vprintf printf stdout Verifique se há nulos. não
vprintf_p printf_p stdout Verifique se há nulos e formato válido. sim
vprintf_s printf_s stdout Verifique se há nulos e formato válido. não
vwprintf wprintf stdout Verifique se há nulos. não
vwprintf_p wprintf_p stdout Verifique se há nulos e formato válido. sim
vwprintf_s wprintf_s stdout Verifique se há nulos e formato válido. não
vsprintf sprintf memória apontada por buffer Verifique se há nulos. não
vsprintf_p sprintf_p memória apontada por buffer Verifique se há nulos e formato válido. sim
vsprintf_s sprintf_s memória apontada por buffer Verifique se há nulos e formato válido. não
vswprintf swprintf memória apontada por buffer Verifique se há nulos. não
vswprintf_p swprintf_p memória apontada por buffer Verifique se há nulos e formato válido. sim
vswprintf_s swprintf_s memória apontada por buffer Verifique se há nulos e formato válido. não
_vscprintf _vscprintf memória apontada por buffer Verifique se há nulos. não
_vscwprintf _vscwprintf memória apontada por buffer Verifique se há nulos. não
_vsnprintf _snprintf memória apontada por buffer Verifique se há nulos. não
_vsnwprintf _snwprintf memória apontada por buffer Verifique se há nulos. não

O argumento argptr tem o tipo va_list, definido em VARARGS.H e STDARG.H. A argptr variável deve ser inicializada por va_start e pode ser reinicializada por chamadas subsequentesva_arg; argptr em seguida, aponta para o início de uma lista de argumentos que são convertidos e transmitidos para saída de acordo com as format especificações correspondentes no argumento. format tem a mesma forma e função que o format argumento para printf. Nenhuma dessas funções invoca va_end. Para obter uma descrição mais completa de cada vprintf funcionam, consulte a descrição de sua função equivalente, conforme listado na tabela anterior.

_vsnprintf difere de vsprintf que não grava mais do que count bytes em buffer.

As versões dessas funções com o infixo w no nome são versões de caracteres largos das funções correspondentes sem o infixo w ; em cada uma dessas funções de caracteres largos, buffer e format são cadeias de caracteres largos. Caso contrário, cada função de caractere largo se comporta de forma idêntica à sua função equivalente do SBCS.

As versões dessas funções com _s sufixos e _p são as versões mais seguras. Essas versões validam as cadeias de caracteres de formato. Eles gerarão uma exceção se a cadeia de caracteres de formato não estiver bem formada (por exemplo, se caracteres de formatação inválidos forem usados).

As versões dessas funções com o _p sufixo permitem especificar a ordem na qual os argumentos fornecidos são substituídos na cadeia de caracteres de formato. Para obter mais informações, consulte Parâmetros posicionais printf_p.

Para vsprintf, vswprintf, _vsnprintf e _vsnwprintf, se a cópia ocorrer entre cadeias de caracteres que se sobrepõem, o comportamento será indefinido.

Importante

Verifique se format não é uma cadeia de caracteres definida pelo usuário. Para obter mais informações, confira Como evitar sobrecargas de buffer. Se estiver usando as versões seguras dessas funções (sufixos ou _s _p ou), uma cadeia de caracteres de formato fornecida pelo usuário poderá disparar uma exceção de parâmetro inválido se a cadeia de caracteres fornecida pelo usuário contiver caracteres de formatação inválidos.

Confira também

E/S de fluxo
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
va_arg, va_copy, va_end, va_start