fputs, fputws
ストリームに文字列を書き込みます。
構文
int fputs(
const char *str,
FILE *stream
);
int fputws(
const wchar_t *str,
FILE *stream
);
パラメーター
str
出力する文字列。
stream
FILE 構造体へのポインター。
戻り値
成功した場合、これらの各関数は負でない値を返します。 エラーが発生した場合は、fputs と fputws は EOF を返します。 strまたはstreamが null ポインターの場合、「パラメーター検証で説明されているように、これらの関数は無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、これらの関数は errno を EINVAL に設定し、EOF を返します。
エラー コードの詳細については、「 errno、 _doserrno、 _sys_errlist、および _sys_nerr」を参照してください。
解説
これらの関数は、出力 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.