_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Artigo
08/25/2010

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