fputs、fputws
ストリームに文字列を書き込みます。
int fputs(
const char *str,
FILE *stream
);
int fputws(
const wchar_t *str,
FILE *stream
);
パラメーター
str
出力する文字列。stream
FILE 構造体へのポインター。
戻り値
これらの関数は、正常に終了した場合に 0 以上の値を返します。 エラーが発生した場合は、fputs と fputws は EOF を返します。 str または stream が null ポインターの場合、「パラメーターの検証」に説明されているように、これらの関数は無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、これらの関数は errno を EINVAL に設定します。fputs は EOF を返し、fputws は WEOF を返します。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
これらの関数は、出力 stream の現在位置に str をコピーします。 fputws は、ワイド文字引数 str を、stream がテキスト モードで開かれるか、バイナリ モードで開かれるかに応じて、マルチバイト文字列またはワイド文字列として stream にコピーします。 どちらの関数も、終端の null 文字をコピーしません。
ストリームが ANSI モードで開かれている場合、2 つの関数の動作は同じになります。 fputs では、UNICODE ストリームへの出力はサポートされていません。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE & _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_fputts |
fputs |
fputs |
fputws |
必要条件
関数 |
必須ヘッダー |
|---|---|
fputs |
<stdio.h> |
fputws |
<stdio.h> または <wchar.h> |
コンソールは、Windows ストア アプリではサポートされていません。 コンソール (stdin、stdout、および stderr) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって Windows ストア アプリで使用する前に、リダイレクトする必要があります。 互換性の詳細については、「互換性」を参照してください。
使用例
// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.
#include <stdio.h>
int main( void )
{
fputs( "Hello world from fputs.\n", stdout );
}
同等の .NET Framework 関数
System::IO::StreamWriter::Write