_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Retorna o número de caracteres na seqüência de caracteres formatada usando um ponteiro para uma lista de argumentos.

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 
);

Parâmetros

  • format
    Seqüência de caracteres de controle de formato.

  • argptr
    Ponteiro para a lista de argumentos.

  • locale
    A localidade para usar.

Para obter mais informações, consulte Especificações de formato.

Valor de retorno

_vscprintf Retorna o número de caracteres seria gerado se a seqüência de caracteres apontada pela lista de argumentos foi impresso ou enviado para um arquivo ou o buffer usando os códigos de formatação especificados. O valor retornado não inclui o caractere nulo de terminação._vscwprintf executa a mesma função de caracteres largos.

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

If format é um ponteiro nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, as funções retornam -1 e conjunto errno para EINVAL.

Comentários

Cada argument (se houver) convertidas de acordo com a especificação de formato correspondente em format. O formato consiste em caracteres comuns e tenha o mesmo formulário e funcione sistema autônomo a format argumento para printf.

Observação de segurança:

Certifique-se de que, se format é uma seqüência de caracteres definida pelo usuário, ele é terminada nula e tem o número correto e o tipo de parâmetros. Para obter mais informações, consulte Evitar saturações de buffer.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H

_UNICODE & _MBCS não definido

_MBCS definido

_UNICODE definido

_vsctprintf

_vscprintf

_vscprintf

_vscwprintf

_vsctprintf_l

_vscprintf_l

_vscprintf_l

_vscwprintf_l

Requisitos

Rotina

Cabeçalho necessário

_vscprintf, _vscprintf_l

<stdio.h>

_vscwprintf, _vscwprintf_l

<stdio.h> ou <wchar.h>

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

Exemplo

Consulte o exemplo para vsprintf.

Consulte também

Referência

Fluxo de E/S

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

scanf, _scanf_l, wscanf, _wscanf_l

sscanf, _sscanf_l, swscanf, _swscanf_l

Funções vprintf