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

参照

関連項目

ストリーム入出力

fgets、fgetws

gets、_getws

puts、_putws