fputc、fputwc
ストリームに文字を書き込みます。
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 を書き込み (定義されている場合)、必要に応じて指示子を進めます。 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> |
コンソールは、Windows ストア アプリではサポートされていません。 コンソール (stdin、stdout、および stderr) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって Windows ストア アプリで使用する前に、リダイレクトする必要があります。 互換性の詳細については、「互換性」を参照してください。
使用例
// 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 ) ;
}