_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Artigo
06/09/2015

Retorna o número de caracteres na cadeia de caracteres formatada, com a capacidade de especificar a ordem em que os parâmetros são usados na cadeia de caracteres de formato.

int _scprintf_p(
   const char *format [,
   argument] ... 
);
int _scprintf_p_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf_p (
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_p _l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Parâmetros

format
Cadeia de caracteres de controle de formato.
argument
Argumentos opcionais.
locale
A localidade a ser usada.

Valor de retorno

Retorna o número de caracteres que serão gerados se a cadeia de caracteres devia ser impressa ou enviado a um arquivo ou um buffer usando os códigos de formatação especificados. O valor retornado não inclui o caractere nulo sendo encerrado. _scwprintf_p executa a mesma função para caracteres amplos.

A diferença entre _scprintf_p e _scprintf é que _scprintf_p oferece suporte aos parâmetros posicionais, o que permite especificar a ordem em que os argumentos são usados na cadeia de caracteres de formato. Para obter mais informações, consulte Parâmetros posicionais printf_p.

Se format é um ponteiro NULL, o parâmetro de manipulador inválido é invocado, como descrito em Validação do parâmetro. Se a execução puder continuar, essas funções retornarão -1 e definirão errno a EINVAL.

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

Comentários

Cada argument (se houver) é convertido de acordo com a especificação de formato correspondente em format. O formato consiste em caracteres comuns e tem o mesmo formato e função do que o argumento format para printf.

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

Observação de segurança
Verifique se format não é uma cadeia de caracteres definida pelo usuário.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_sctprintf_p	_scprintf_p	_scprintf_p	_scwprintf_p
_sctprintf_p_l	_scprintf_p_l	_scprintf_p_l	_scwprintf_p_l

Requisitos

Rotina	Cabeçalho necessário
_scprintf_p, _scprintf_p_l	<stdio.h>
_scwprintf_p, _scwprintf_p_l	<stdio.h> ou <wchar.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Consulte também

Referência

E/S de fluxo

_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Compartilhar via