_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l
Imprime dados em um fluxo em formato.
int _fprintf_p(
FILE *stream,
const char *format [,
argument ]...
);
int _fprintf_p_l(
FILE *stream,
const char *format,
locale_t locale [,
argument ]...
);
int _fwprintf_p(
FILE *stream,
const wchar_t *format [,
argument ]...
);
int _fwprintf_p_l(
FILE *stream,
const wchar_t *format,
locale_t locale [,
argument ]...
);
Parâmetros
stream
Ponteiro para o FILE estrutura.format
Seqüência de caracteres de controle de formato.argument
Argumentos opcionais.locale
A localidade para usar.
Valor de retorno
_fprintf_pe _fwprintf_p retornar o número de caracteres gravados ou retornar um valor negativo, quando ocorre um erro de saída.
Comentários
_fprintf_pformata e imprime uma série de caracteres e valores para a saída stream.Cada função argument (se houver) são convertidos e saída de acordo com a especificação de formato correspondente em format.Para _fprintf_p, o format argumento tem a mesma sintaxe e uso que possui na _printf_p.Essas funções de suportam a parâmetros posicionais, significando que a ordem dos parâmetros usados pela seqüência de caracteres de formato pode ser alterada.Para obter mais informações sobre parâmetros de posição, consulte printf_p parâmetros posicional.
_fwprintf_pé uma versão de caractere largo de _fprintf_p; na _fwprintf_p, format é uma seqüência de caracteres largos.Essas funções se comportar de forma idêntica se o fluxo é aberto no modo ANSI._fprintf_patualmente não suporta a saída em um fluxo UNICODE.
As versões dessas funções com o _l sufixo são idênticas exceto que eles usam o parâmetro de localidade passado em vez da localidade atual.
Observação de segurança |
---|
Certifique-se de que format não é uma seqüência definida pelo usuário. |
Como as versões não seguro (consulte fprintf, _fprintf_l, fwprintf, _fwprintf_l), essas funções validar seus parâmetros e chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro, se qualquer um dos stream ou format é um ponteiro nulo ou se houver qualquer especificadores de formatação desconhecidos ou mal formatados.Se a execução terá permissão para continuar, as funções retornam -1 e defina errno para EINVAL.
Mapeamentos de rotina de texto genérico
Rotina de TCHAR.h |
_ Unicode e _ MBCS do arquivo não definido |
_ MBCS do arquivo definido |
_ Unicode definido |
---|---|---|---|
_ftprintf_p |
_fprintf_p |
_fprintf_p |
_fwprintf_p |
_ftprintf_p_l |
_fprintf_p_l |
_fprintf_p_l |
_fwprintf_p_l |
Para obter mais informações, consulte Especificações de formato.
Requisitos
Função |
Cabeçalho necessário |
---|---|
_fprintf_p, _fprintf_p_l |
<stdio.h> |
_fwprintf_p, _fwprintf_p_l |
<stdio.h> ou <wchar.h> |
Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.
Exemplo
// crt_fprintf_p.c
// This program uses _fprintf_p to format various
// data and print it to the file named FPRINTF_P.OUT. It
// then displays FPRINTF_P.OUT on the screen using the system
// function to invoke the operating-system TYPE command.
//
#include <stdio.h>
#include <process.h>
int main( void )
{
FILE *stream = NULL;
int i = 10;
double fp = 1.5;
char s[] = "this is a string";
char c = '\n';
// Open the file
if ( fopen_s( &stream, "fprintf_p.out", "w" ) == 0)
{
// Format and print data
_fprintf_p( stream, "%2$s%1$c", c, s );
_fprintf_p( stream, "%d\n", i );
_fprintf_p( stream, "%f\n", fp );
// Close the file
fclose( stream );
}
// Verify our data
system( "type fprintf_p.out" );
}
Equivalência do .NET Framework
System::IO::StreamWriter::Write
Consulte também
Referência
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
printf_p parâmetros posicional
_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l