fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l_ftprintf, _ftprintf_l, _ftprintf_s, _ftprintf_s_l

Imprima dados formatados em um fluxo. Essas funções são versões de fprintf, _fprintf_l, , com aprimoramentos de segurança, fwprintf_fwprintf_l conforme descrito em Recursos de segurança no CRT.

Para _ftprintf_s e _ftprintf_s_l, consulte Mapeamentos de função de texto genérico.

Sintaxe

int fprintf_s(
   FILE *stream,
   const char *format [,
   argument_list ]
);
int _fprintf_s_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument_list ]
);
int fwprintf_s(
   FILE *stream,
   const wchar_t *format [,
   argument_list ]
);
int _fwprintf_s_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument_list ]
);

Parâmetros

stream
Ponteiro para a FILE estrutura.

format
Cadeia de caracteres de controle de formato.

argument_list
Argumentos opcionais para a cadeia de caracteres de formato.

locale
A localidade a ser usada.

Valor de retorno

fprintf_s Retorna o número de bytes gravados. fwprintf_s Retorna o número de caracteres largos gravados. Cada uma dessas funções retorna um valor negativo quando ocorre um erro de saída.

Observações

fprintf_s formata e imprime uma série de caracteres e valores para a saída stream. Cada argumento em argument_list (se houver) é convertido e saída de acordo com a especificação de formato correspondente em format. O format argumento usa a sintaxe de especificação de formato para printf e wprintf funções.

fwprintf_sé uma versão de caracteres largos de ; em fwprintf_s, format é uma cadeia de fprintf_scaracteres largos. Essas funções se comportam de forma idêntica se o fluxo for aberto no modo ANSI. fprintf_s atualmente não suporta saída em um fluxo UNICODE.

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

Como as versões não seguras (consulte fprintf, _fprintf_l, , fwprintf_fwprintf_l), essas funções validam seus parâmetros e invocam o manipulador de parâmetros inválido, conforme descrito em Validação de parâmetros, se um ou streamformat for um NULL ponteiro. A própria cadeia de caracteres de formato também é validada. Se houver algum especificador de formatação desconhecido ou mal formado, essas funções gerarão a exceção de parâmetro inválido. Em todos os casos, se a execução for permitida para continuar, as funções retornarão -1 e definirão errno como EINVAL. Para obter mais informações sobre códigos de retorno, consulte errno, _doserrno, _sys_errliste _sys_nerr.

Mapeamentos de função de texto genérico

A função na coluna mapeia tchar.h para a função nas outras colunas, dependendo do conjunto de caracteres definido em tempo de compilação.

Para obter mais informações, consulte Sintaxe da especificação de formato.

Requerimentos

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_fprintf_s.c
// This program uses fprintf_s to format various
// data and print it to the file named FPRINTF_S.OUT. It
// then displays FPRINTF_S.OUT on the screen using the system
// function to invoke the operating-system TYPE command.

#include <stdio.h>
#include <process.h>

FILE *stream;

int main( void )
{
   int    i = 10;
   double fp = 1.5;
   char   s[] = "this is a string";
   char   c = '\n';

   fopen_s( &stream, "fprintf_s.out", "w" );
   fprintf_s( stream, "%s%c", s, c );
   fprintf_s( stream, "%d\n", i );
   fprintf_s( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf_s.out" );
}

this is a string
10
1.500000

Ver também

de E/S de fluxo
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l