_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Artigo
03/12/2013

Imprime saída formatados para o fluxo de saída padrão, com a capacidade para especificar a 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 se ocorrer um erro.

Comentários

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

A diferença entre _printf_pe printf_sé que _printf_psuporta parâmetros posicionais, que permite especificar a ordem em que os argumentos são usados na cadeia de caracteres de formato.Para obter mais informações, consulte printf_p parâmetros posicional.

_wprintf_p é a versão do largo- caractere de _printf_p; se comportam de forma idêntica se o fluxo é aberta no modo ANSI._printf_p não tem suporte para a saída em um fluxo de UNICODE.

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

Observação de segurança
Certifique-se de que format não é uma cadeia de caracteres definida pelo usuário.

Se format ou argument são NULL, ou de cadeia de caracteres de formato de formatação contém caracteres inválidos, _printf_p e funções de _wprintf_p chamam um manipulador de parâmetro inválido, como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função retorna -1 e defina errno a EINVAL.

Mapeamentos da rotina de Genérico- texto

Rotina de Tchar.h	_UNICODE e não definidos _MBCS	_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 é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para mais informações, consulte Compatibilidade de 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);
}