Compartilhar via


_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Imprime formatado saída para o fluxo de saída padrão, a capacidade de especificar a ordem na qual os parâmetros são usados na seqüência de caracteres de formato.

int _printf_p(
   const char *format [,
      argument]... 
);
int _printf_p_l(
   const char *format,
   locale_t locale [,
      argument]... 
);
int _wprintf_p(
   const wchar_t *format [,
      argument]... 
);
int _wprintf_p_l(
   const wchar_t *format,
   locale_t locale [,
      argument]... 
);

Parâmetros

  • format
    Controle de formato.

  • argument
    Argumentos opcionais.

  • locale
    A localidade para usar.

Valor de retorno

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

Comentários

The _printf_p função formata e imprime uma série de caracteres e valores no fluxo de saída padrão stdout. Se os argumentos seguem o format seqüência de caracteres, o format seqüência deve conter as especificações que determinam o formato de saída para os argumentos (consulte printf_p posicional parâmetros).

A diferença entre _printf_p e printf_s é o _printf_p oferece 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.

_wprintf_p é a versão de caractere largo da _printf_p; eles tenham comportamento idêntico se o fluxo é aberto no modo ANSI. _printf_p atualmente não suporta saída em um fluxo UNICODE.

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.

Observação de segurança:

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

If format ou argument são NULL, ou do formato de seqüência de caracteres contém caracteres inválidos de formatação, _printf_p e _wprintf_p funções chamar um manipulador de parâmetro inválido, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, a função retorna -1 e define errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina tchar.h

_UNICODE e _MBCS não definido

_MBCS definido

_UNICODE definido

_tprintf_p

_printf_p

_printf_p

_wprintf_p

_tprintf_p_l

_printf_p_l

_printf_p_l

_wprintf_p_l

Requisitos

Rotina

Cabeçalho necessário

_printf_p, _printf_p_l

<stdio.h>

_wprintf_p, _wprintf_p_l

<stdio.h> ou <wchar.h>

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

Exemplo

// crt_printf_p.c
// This program uses the _printf_p and _wprintf_p
// functions to choose the order in which parameters
// are used.

#include <stdio.h>

int main( void )
{
   // Positional arguments 
   _printf_p( "Specifying the order: %2$s %3$s %1$s %4$s %5$s.\n",
              "little", "I'm", "a", "tea", "pot");

   // Resume arguments
   _wprintf_p( L"Reusing arguments: %1$d %1$d %1$d %1$d\n", 10);

   // Width argument
   _printf_p("Width specifiers: %1$*2$s", "Hello\n", 10);
}

Specifying the order: I'm a little tea pot. Reusing arguments: 10 10 10 10 Width specifiers:     Hello

Equivalente do NET Framework

Consulte também

Referência

Suporte de ponto flutuante

Fluxo de E/S

Localidade

fopen, _wfopen

_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l

fprintf, _fprintf_l, fwprintf, _fwprintf_l

fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

scanf, _scanf_l, wscanf, _wscanf_l

scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l

_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l

Funções vprintf