fputs, fputws

  • [アーティクル]

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

構文

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

パラメーター

str
出力する文字列。

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

戻り値

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

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

解説

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

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

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 これを変更するには、「CRT でのグローバル状態」を参照してください。

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

TCHAR.H のルーチン _UNICODE と _MBCS が定義されていない _MBCS が定義されている _UNICODE が定義されている
_fputts fputs fputs fputws

必要条件

機能 必須ヘッダー
fputs <stdio.h>
fputws <stdio.h> または <wchar.h>

ユニバーサル Windows プラットフォーム (UWP) アプリではコンソールがサポートされていません。 UWP アプリで C ランタイム関数が、コンソールに関連付けられている標準ストリーム ハンドル (stdin、stdout、stderr) を使用するには、それらのハンドルを事前にリダイレクトしておく必要があります。 互換性の詳細については、「 Compatibility」を参照してください。

例

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

関連項目

ストリーム入出力
fgets, fgetws
gets, _getws
puts, _putws