fputs、fputws

[アーティクル]
08/09/2011

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

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 に、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 );
}