fputs、fputws
ストリームに文字列を記述します。
int fputs(
const char *str,
FILE *stream
);
int fputws(
const wchar_t *str,
FILE *stream
);
パラメーター
str
文字列を出力します。stream
FILE 構造体へのポインター。
戻り値
これらの関数は成功した場合は、負の値を返します。エラーの場合、fputs は EOFと fputws を返します WEOFを返します。strstream またはが null ポインターの場合、これらの関数は パラメーターの検証に説明されているように、無効なパラメーター ハンドラーが実行されます。実行の継続が許可 EINVAL に対するこれらの関数によって設定された errno と戻り値の EOF または WEOF。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
これらの関数は現在位置に出力 stream に str をコピーします。fputws、マルチバイト文字列または文字列として stream に stream が binary テキスト モードまたはモードで開くかどうかによってワイド文字の引数 str を個別にコピーします。どちらもコピー終端の null 文字は機能しません。
2 個の関数は、ストリームが ANSI モードで開いている場合、動作は同じです。fputs では、UNICODE ストリームへの出力はサポートされていません。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_fputts |
fputs |
fputs |
fputws |
必要条件
Function |
必須ヘッダー |
|---|---|
fputs |
<stdio.h> |
fputws |
<stdio.h> または <wchar.h> |
コンソールは Windows ストア の apps ではサポートされていません。コンソール、stdin、stdout、および stderrに関連付けられている標準ストリームのハンドルは C のランタイム関数が Windows ストア の apps で使用する前にをリダイレクトする必要があります。互換性の詳細については、「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 );
}
同等の .NET Framework 関数
System::IO::StreamWriter::Write