fprintf_s、_fprintf_s_l、fwprintf_s、_fwprintf_s_lfprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l

書式付きデータをストリームに出力します。Print formatted data to a stream. これらは、「CRT のセキュリティ機能」の説明にあるとおり、セキュリティが強化されたバージョンの fprintf、_fprintf_l、fwprintf、_fwprintf_l です。These are versions of fprintf, _fprintf_l, fwprintf, _fwprintf_l with security enhancements as described in Security Features in the CRT.

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

パラメーターParameters

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

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

argument_listargument_list
書式指定文字列に省略可能な引数。Optional arguments to the format string.

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

戻り値Return Value

fprintf_s書き込まれたバイト数を返します。fprintf_s returns the number of bytes written. fwprintf_s書き込まれたワイド文字の数を返します。fwprintf_s returns the number of wide characters written. これらの関数は、出力エラーが発生した場合、負の値を返します。Each of these functions returns a negative value instead when an output error occurs.

RemarksRemarks

fprintf_s書式化して、一連の文字や、出力値を出力ストリームします。fprintf_s formats and prints a series of characters and values to the output stream. 各引数argument_list (ある場合) は変換されに対応する書式指定に応じて形式します。Each argument in argument_list (if any) is converted and output according to the corresponding format specification in format. 形式引数は、書式指定構文の printf および wprintf 関数します。The format argument uses the format specification syntax for printf and wprintf functions.

fwprintf_sのワイド文字バージョンは、 fprintf_sfwprintf_s形式はワイド文字列です。fwprintf_s is a wide-character version of fprintf_s; in fwprintf_s, format is a wide-character string. ストリームが ANSI モードで開かれている場合、これらの関数の動作は同じになります。These functions behave identically if the stream is opened in ANSI mode. fprintf_s UNICODE ストリームへの出力をサポートされていません。fprintf_s doesn't 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 locale.

重要

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

保護されていないバージョンと同様 (を参照してくださいfprintf、_fprintf_l、fwprintf、_fwprintf_l)、これらの関数は、パラメーターを検証し、で説明されているように、無効なパラメーター ハンドラーを呼び出しますパラメーターの検証である場合ストリームまたは形式null ポインターです。Like the non-secure versions (see fprintf, _fprintf_l, fwprintf, _fwprintf_l), these functions validate their parameters and invoke the invalid parameter handler, as described in Parameter Validation, if either stream or format is a null pointer. 書式指定文字列自体はも検証されます。The format string itself is also validated. 未知の書式指定子や不適切な形式の書式指定子がある場合、これらの関数は無効なパラメーター例外を生成します。If there are any unknown or badly formed formatting specifiers, these functions generate the invalid parameter exception. すべてのケースで続けるには、実行が許可された場合、関数は-1 を返し設定とerrnoEINVALします。In all cases, If execution is allowed to continue, the functions return -1 and set errno to EINVAL. エラー コードの詳細については、「_doserrno、errno、_sys_errlist、_sys_nerr」をご覧ください。See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

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

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_ftprintf_s_ftprintf_s fprintf_sfprintf_s fprintf_sfprintf_s fwprintf_sfwprintf_s
_ftprintf_s_l_ftprintf_s_l _fprintf_s_l_fprintf_s_l _fprintf_s_l_fprintf_s_l _fwprintf_s_l_fwprintf_s_l

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

必要条件Requirements

関数Function 必須ヘッダーRequired header
fprintf_s_fprintf_s_lfprintf_s, _fprintf_s_l <stdio.h><stdio.h>
fwprintf_s_fwprintf_s_lfwprintf_s, _fwprintf_s_l <stdio.h> または <wchar.h><stdio.h> or <wchar.h>

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

Example

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

関連項目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