fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l, _ftprintf, , _ftprintf_l, , _ftprintf_s_ftprintf_s_l

Skriv ut formaterade data till en ström. Dessa funktioner är versioner av fprintf, _fprintf_l, fwprintf, _fwprintf_l med säkerhetsförbättringar enligt beskrivningen i Säkerhetsfunktioner i CRT.

För _ftprintf_s och _ftprintf_s_l, se Generic-text-funktionsmappningar.

Syntax

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

Parameterar

stream
Pekare till FILE struktur.

format
Formatkontrollsträng.

argument_list
Valfria argument till formatsträngen.

locale
Språkvarianten som ska användas.

Returvärde

fprintf_s returnerar antalet skrivna byte. fwprintf_s returnerar antalet breda tecken som skrivits. Var och en av dessa funktioner returnerar ett negativt värde i stället när ett utdatafel inträffar.

Anmärkningar

fprintf_s formaterar och skriver ut en serie tecken och värden till utdata stream. Varje argument i argument_list (om det finns några) konverteras och utdata enligt motsvarande formatspecifikation i format. Argumentet format använder formatspecifikationssyntaxen för printf och wprintf funktionerna.

fwprintf_s är en bred teckenversion av fprintf_s, i fwprintf_s, format är en sträng med många tecken. Dessa funktioner fungerar identiskt om strömmen öppnas i ANSI-läge. fprintf_s stöder för närvarande inte utdata till en UNICODE-ström.

Versionerna av dessa funktioner med suffixet _l är identiska förutom att de använder språkparametern som skickas i stället för det aktuella språket.

Precis som de icke-säkra versionerna (se fprintf, _fprintf_l, fwprintf), _fwprintf_lverifierar dessa funktioner sina parametrar och anropar den ogiltiga parameterhanteraren enligt beskrivningen i Parameterverifiering, om det är en streamNULL pekare.format Själva formatsträngen verifieras också. Om det finns några okända eller felaktigt formateringsspecificerare genererar dessa funktioner det ogiltiga parameterfelet. Om körningen tillåts fortsätta returnerar funktionerna i alla fall -1 och är inställda errno på EINVAL. Mer information om returkoder finns i errno, _doserrno, _sys_errlistoch _sys_nerr.

Mappningar av funktionen Generic-text

Funktionen i tchar.h kolumnen mappar till funktionen i de andra kolumnerna beroende på vilken teckenuppsättning som definieras vid kompileringstiden.

Mer information finns i Syntax för formatspecifikation.

Kravspecifikation

Mer kompatibilitetsinformation finns i Kompatibilitet.

Exempel

// 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

Se även

Strömma I/O
_cprintf, _cprintf_l, , _cwprintf_cwprintf_l
fscanf, _fscanf_l, , fwscanf_fwscanf_l
sprintf, _sprintf_l, swprintf, , , _swprintf_l__swprintf_l