_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Artigo
07/29/2015

Imprime a saída formatada para o fluxo de saída padrão, e permite a especificação da ordem em que os parâmetros são usados na cadeia 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 a ser usada.

Valor de retorno

Retorna o número de caracteres impressos ou um valor negativo, caso ocorra um erro.

Comentários

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

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

_wprintf_p é a versão de caracteres largos de _printf_p; elas comportarão de forma idêntica se o fluxo for aberto no modo de ANSI. No momento, _printf_p não tem suporte para saída em fluxo UNICODE.

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.

Se format ou argument forem NULL, ou se a cadeia de caracteres de formato conter caracteres de formatação inválidos, as funções _printf_p e _wprintf_p chamam um manipulador de parâmetro inválido, conforme descrito em Validação do parâmetro. Se a execução puder continuar, a função retornará -1 e definirá errno a 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>

O console não tem suporte em aplicativos do Windows Store. Os manipuladores de fluxo padrão associados ao console — stdin, stdout e stderr — devem ser redirecionados antes que as funções de tempo de execução do C possam utilizá-los em aplicativos do Windows Store. Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

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);
}