fprintf、_fprintf_l、fwprintf、_fwprintf_lfprintf, _fprintf_l, fwprintf, _fwprintf_l

書式付きデータをストリームに出力します。Print formatted data to a stream. これらの関数のセキュリティを強化したバージョンを使用できます。「fprintf_s、_fprintf_s_l、fwprintf_s、_fwprintf_s_l」をご覧ください。More secure versions of these functions are available; see fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

構文Syntax

int fprintf(
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_l(
   FILE *stream,
   const char *format,
   locale_t locale [,
   argument ]...
);
int fwprintf(
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale [,
   argument ]...
);

パラメーターParameters

一連stream
FILE 構造体へのポインター。Pointer to FILE structure.

formatformat
書式指定文字列。Format-control string.

argumentargument
省略可能な引数。Optional arguments.

localelocale
使用するロケール。The locale to use.

戻り値Return Value

fprintfは、書き込まれたバイト数を返します。fprintf returns the number of bytes written. fwprintfは、書き込まれたワイド文字の数を返します。fwprintf returns the number of wide characters written. これらの関数は、出力エラーが発生した場合、負の値を返します。Each of these functions returns a negative value instead when an output error occurs. StreamまたはformatNULLの場合、「パラメーターの検証」で説明されているように、これらの関数は無効なパラメーターハンドラーを呼び出します。If stream or format is NULL, these functions invoke the invalid parameter handler, as described in Parameter Validation. 実行の継続が許可された場合、これらの関数は-1 を返し、 errnoEINVALに設定します。If execution is allowed to continue, the functions return -1 and set errno to EINVAL. 書式指定文字列は、 fprintf_sまたはfwprintf_sを使用する場合と同じように、有効な書式指定文字に対してチェックされません。The format string is not checked for valid formatting characters as it is when using fprintf_s or fwprintf_s.

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、_sys_nerr」をご覧ください。See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

RemarksRemarks

fprintfは、一連の文字と値を書式設定し、出力ストリームに出力します。fprintf formats and prints a series of characters and values to the output stream. 各関数の引数(存在する場合) は、対応する書式指定に従って変換および出力されます。Each function argument (if any) is converted and output according to the corresponding format specification in format. Fprintfの場合、 format引数の構文と、 printfで使用される構文は同じです。For fprintf, the format argument has the same syntax and use that it has in printf.

fwprintfは、 fprintfのワイド文字バージョンです。fwprintfでは、 formatはワイド文字列です。fwprintf is a wide-character version of fprintf; in fwprintf, format is a wide-character string. ストリームが ANSI モードで開かれている場合、これらの関数の動作は同じになります。These functions behave identically if the stream is opened in ANSI mode. fprintfは、現在 UNICODE ストリームへの出力をサポートしていません。fprintf does not currently support output into a UNICODE stream.

_Lサフィックスを持つこれらの関数のバージョンは、現在のスレッドロケールの代わりに渡されたロケールパラメーターを使用する点を除いて同じです。The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current thread locale.

重要

format にユーザー定義の文字列を指定しないでください。Ensure that format is not a user-defined string.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
ftprintf (_d)_ftprintf fprintffprintf fprintffprintf fwprintffwprintf
ftprintf_l (_d)_ftprintf_l _fprintf_l_fprintf_l _fprintf_l_fprintf_l _fwprintf_l_fwprintf_l

詳細については、「 printf 関数と wprintf 関数の書式指定フィールド」を参照してください。For more information, see Format Specifications.

必要条件Requirements

関数Function 必須ヘッダーRequired header
fprintf_fprintf_lfprintf, _fprintf_l <stdio.h><stdio.h>
fwprintf_fwprintf_lfwprintf, _fwprintf_l <stdio.h> または <wchar.h><stdio.h> or <wchar.h>

互換性の詳細については、「 互換性」を参照してください。For additional compatibility information, see Compatibility.

Example

// crt_fprintf.c
/* This program uses fprintf to format various
* data and print it to the file named FPRINTF.OUT. It
* then displays FPRINTF.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.out", "w" );
   fprintf( stream, "%s%c", s, c );
   fprintf( stream, "%d\n", i );
   fprintf( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf.out" );
}
this is a string
10
1.500000

関連項目See also

ストリーム入出力Stream I/O
_cprintf、_cprintf_l、_cwprintf、_cwprintf_l_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf、_fscanf_l、fwscanf、_fwscanf_lfscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
書式指定構文: printf 関数と wprintf 関数Format Specification Syntax: printf and wprintf Functions