_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Artigo
08/25/2010

Os formatos e imprime do console, com suporte para parâmetros de posição na seqüência de caracteres de formato.

int _cprintf_p( 
   const char * format [, 
      argument] ... 
);
int _cprintf_p_l( 
   const char * format,
   locale_t locale [, 
      argument] ... 
);
int _cwprintf_p(
   const wchar * format [, 
      argument] ...
);
int _cwprintf_p_l(
   const wchar * format,
   locale_t locale [,
      argument] ...
);

Parâmetros

format
Seqüência de caracteres de controle de formato.
argument
Parâmetros opcionais.
locale
A localidade para usar.

Valor de retorno

O número de caracteres impressos ou um valor negativo se ocorrer um erro.

Comentários

Essas funções Formatar e imprimir uma série de caracteres e valores diretamente ao console, usando o _putch e _putwch funções para caracteres de saída. Cada argument (se houver) é convertido e saída de acordo com a especificação de formato correspondente em format. O formato tenha o mesmo formulário e função sistema autônomo a format parâmetro para o printf_p função.A diferença entre _cprintf_pe cprintf_sé o _cprintf_poferece suporte a parâmetros posicionais, que permite especificar a ordem em que os argumentos são usados na seqüência de caracteres de formato. For more information, see printf_p posicional parâmetros.

Ao contrário de fprintf_p, printf_p, e sprintf_p funciona, nem _cprintf_p nem _cwprintf_p Converte caracteres de avanço de linha em return–line de carro (CR-LF) combinações de feed durante a impressão. Uma distinção importante é que _cwprintf_p Exibe caracteres Unicode quando usado no Windows NT. Ao contrário de _cprintf_p, _cwprintf_p utiliza as configurações de localidade corrente do console.

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 corrente.

Observação de segurança:
Certifique-se de que format não é uma seqüência de caracteres definida pelo usuário.

Além disso, como _cprintf_s e _cwprintf_s, eles validar o ponteiro de entrada e a seqüência de caracteres de formato. If format ou argument são NULL, ou do formato de seqüência de caracteres contém caracteres inválidos de formatação, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornam -1 e conjunto errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina tchar.h	_UNICODE e _MBCS não definido	_MBCS definido	_UNICODE definido
_tcprintf_p	_cprintf_p	_cprintf_p	_cwprintf_p
_tcprintf_p_l	_cprintf_p_l	_cprintf_p_l	_cwprintf_p_l

Requisitos

Rotina	Cabeçalho necessário
_cprintf_p, _cprintf_p_l	<conio.h>
_cwprintf_p, _cwprintf_p_l	<conio.h>

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

Exemplo

// crt_cprintf_p.c
// This program displays some variables to the console
// using the _cprintf_p function.

#include <conio.h>

int main( void )
{
    int         i = -16,
                h = 29;
    unsigned    u = 62511;
    char        c = 'A';
    char        s[] = "Test";

    // Note that console output does not translate
    // \n as standard output does. Use \r\n instead.
    _cprintf_p( "%2$d  %1$.4x  %3$u  %4$c %5$s\r\n", 
                h, i, u, c, s );
}

-16  001d  62511  A Test