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の場合、これらの関数は パラメーターの検証に説明されているように、無効なパラメーター ハンドラーが実行されます。実行の継続が許可された場合、これらは EINVALに EOF と同様に errno を返します。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
これらの関数は適切に関連付けられたファイルの位置 (ティッカーを定義する場合)、および事前によってインジケーター指定された位置からファイルに一つの文字 c を書き込みます。fputc と fputwcの場合、ファイルは streamに関連付けられます*。*ファイルが配置の要求をサポートできないし、追加するモードを開かなかった場合は、文字をストリームの末尾に追加されます。
2 個の関数は、ストリームが ANSI モードで開いている場合、動作は同じです。fputc では、UNICODE ストリームへの出力はサポートされていません。
_nolock のサフィックスのバージョンは同じですが、他のスレッドによって干渉から保護されません。詳細については、_fputc_nolock、_fputwc_nolockを参照してください。
ルーチン特定の注意を示します。
ルーチン |
解説 |
|---|---|
fputc |
putcと同じですが、関数とマクロではなく関数としてだけ実行されます。 |
fputwc |
fputcのワイド文字バージョン。stream が binary テキスト モードまたはモードで開くかどうかに応じてマルチバイト文字またはワイド文字として記述し c。 |
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_fputtc |
fputc |
fputc |
fputwc |
必要条件
Function |
必須ヘッダー |
|---|---|
fputc |
<stdio.h> |
fputwc |
<stdio.h> または <wchar.h> |
コンソールは Windows ストア の apps ではサポートされていません。コンソール、stdin、stdout、および stderrに関連付けられている標準ストリームのハンドルは C のランタイム関数が Windows ストア の apps で使用する前にをリダイレクトする必要があります。互換性の詳細については、「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 ) ;
}