fputs、fputws

更新 : 2007 年 11 月

ストリームに文字列を書き込みます。

int fputs( 
   const char *str,
   FILE *stream 
);
int fputws( 
   const wchar_t *str,
   FILE *stream 
);

パラメータ

  • str
    出力する文字列。

  • stream
    FILE 構造体へのポインタ。

戻り値

これらの各関数は、正常に処理されると負でない値を返します。エラーが発生すると、fputs 関数は EOF を返し、fputws 関数は WEOFを返します。str または stream が null ポインタの場合、「パラメータの検証」に説明されているように、これらの関数は無効なパラメータ ハンドラを呼び出します。実行の継続が許可された場合、errno を EINVAL に設定し、EOF または WEOF を返します。

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

これらの各関数は、出力 stream の現在位置に str をコピーします。fputws は、ワイド文字引数 str をコピー、stream がテキスト モードで開かれた場合はマルチバイト文字列としてコピーし、バイナリ モードで開かれた場合はワイド文字列としてコピーします。どちらの関数も、末尾の NULL 文字はコピーしません。

ストリームが ANSI モードで開かれている場合、この 2 つの関数の動作は同じになります。fputs では、現在、UNICODE ストリームへの出力がサポートされていません。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_fputts

fputs

fputs

fputws

必要条件

関数

必須ヘッダー

fputs

<stdio.h>

fputws

<stdio.h> または <wchar.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

// 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 );
}

Hello world from fputs.

.NET Framework の相当するアイテム

System::IO::StreamWriter::Write

参照

参照

ストリーム入出力

fgets、fgetws

gets、_getws

puts、_putws