Compartilhar via


_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

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

Consulte também

Referência

Console e porta de E/s

_cscanf, _cscanf_l, _cwscanf, _cwscanf_l

_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l

_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

fprintf, _fprintf_l, fwprintf, _fwprintf_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

printf, _printf_l, wprintf, _wprintf_l

_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l

_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l

_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

printf_p posicional parâmetros

printf_p posicional parâmetros