次の方法で共有


fputc、fputwc

更新 : 2007 年 11 月

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

int fputc(
   int c,
   FILE *stream 
);
wint_t fputwc(
   wchar_t c,
   FILE *stream 
);

パラメータ

  • c
    書き込む文字。

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

戻り値

これらの各関数は、書き込まれた文字を返します。fputc では、エラーが発生した場合、EOF という値を返します。fputwc では、エラーが発生した場合、WEOF という値を返します。stream が NULL の場合、「パラメータの検証」に説明されているように、これらの関数は無効なパラメータ ハンドラを呼び出します。実行の継続が許可された場合、これらの関数は EOF を返し、errno を EINVAL に設定します。

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

解説

これらの各関数は、関連するファイル位置インジケータが定義されている場合は、ファイル内のインジケータのある位置に c を 1 文字書き込み、インジケータを適宜に進めます。fputc および fputwc の場合、ファイルは stream に関連付けられます。ファイルが位置指定要求をサポートしていない場合、または追加モードで開いている場合、文字はストリームの末尾に追加されます。

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

_nolock サフィックスが付けられたバージョンは、他のスレッドからの干渉から保護されない点を除いて同じです。詳細については、「_fputc_nolock、_fputwc_nolock」を参照してください。

各ルーチンの違いは次のとおりです。

ルーチン

解説

fputc

putc と等価ですが、関数とマクロの両方ではなく、関数としてのみ実装されています。

fputwc

fputc と同じ動作をしますが、ワイド文字を扱うことができます。stream をテキスト モードとバイナリ モードのどちらで開いたかによって、c をマルチバイト文字またはワイド文字として書き込みます。

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

TCHAR.H のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_fputtc

fputc

fputc

fputwc

必要条件

関数

必須ヘッダー

fputc

<stdio.h>

fputwc

<stdio.h> または <wchar.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
 

#include <stdio.h>

int main( void )
{
   char strptr1[] = "This is a test of fputc!!\n";
   char *p;

   // Print line to stream using fputc. 
   p = strptr1;
   while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;

}

This is a test of fputc!!

.NET Framework の相当するアイテム

参照

参照

ストリーム入出力

fgetc、fgetwc

putc、putwc