_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Imprime a saída formatada para o fluxo de saída padrão e permite a especificação da ordem na qual os parâmetros são usados na cadeia de caracteres de formato.

Sintaxe

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
Formatar controle.

argument
Argumentos opcionais.

locale
A localidade a ser usada.

Valor Retornado

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

Comentários

A _printf_p formata e imprime uma série de caracteres e valores no fluxo de saída padrão, stdout. Se os argumentos seguirem a cadeia de caracteres de formato, a cadeia de caracteres de formato deverá conter especificações que determinam o formato de saída para os argumentos (consulte printf_p Parâmetros Posicionais).

A diferença entre _printf_p e printf_s é que _printf_p dá suporte a parâmetros posicionais, o que permite especificar a ordem na qual os argumentos são usados na cadeia de caracteres de formato. Para obter mais informações, consulte Parâmetros posicionais printf_p.

_wprintf_p é a versão de caractere largo do _printf_p; eles se comportam de forma idêntica se o fluxo é aberto no modo ANSI. _printf_p atualmente não dá suporte à saída em um fluxo UNICODE.

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

Importante

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

Se oformato ou argumento for NULL ou se a cadeia de caracteres de formato contiver caracteres de formatação inválidos, as funções _printf_p e _wprintf_p invocarão um manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, a função retornará -1 e define errno como EINVAL.

Mapeamentos da rotina de texto genérico

Rotina Tchar.h _UNICODE e _MBCS não definidos _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>

Não há suporte para o console em Plataforma Universal do Windows (UWP). Os alças de fluxo padrão associados ao console, stdin, stdout e stderr devem ser redirecionados antes que as funções em tempo de run-time C possam usá-las em aplicativos UWP. Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Importante

A partir da Windows 10 2004 (build 19041), printf a família de funções imprime números de ponto flutuante exatamente representáveis de acordo com as regras do IEEE 754 para arredondamento. Nas versões anteriores do Windows, números de ponto flutuante exatamente representáveis terminando em '5' sempre arredondam para cima. O IEEE 754 afirma que eles devem arredondar para o dígito de mesmo valor mais próximo (também conhecido como "Arredondamento do Jogo"). Por exemplo, e printf("%1.0f", 1.5) devem printf("%1.0f", 2.5) arredondar para 2. Anteriormente, 1,5 arredondava para 2 e 2,5 arredondava para 3. Essa alteração afeta apenas números exatamente representáveis. Por exemplo, 2,35 (que, quando representado na memória, é mais próximo de 2,3500000000000008) continua arredondando para 2,4. O arredondamento feito por essas funções agora também respeita o modo de arredondamento de ponto flutuante definido por fesetround. Anteriormente, o arredondamento sempre escolhe o FE_TONEAREST comportamento. Essa alteração afeta apenas os programas criado usando Visual Studio 2019 versão 16.2 e posteriores. Para usar o comportamento de arredondamento de ponto flutuante herddo, vincule com legacy_stdio_float_rounding.obj.

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

Confira também

Suporte a ponto flutuante
E/S de fluxo
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