putc、putwc
ストリームに文字を書き込みます。
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
パラメーター
c
書き込む文字。stream
FILE 構造体へのポインター。
戻り値
書き込まれた文字を返します。 エラーまたはファイルの終端状態を示すには、putc と putchar は EOF を返します。putwc と putwchar は WEOF を返します。 4 つすべてのルーチンで、ferror または feof を使用して、エラーまたはファイルの終端を確認します。 stream に null ポインターが渡された場合、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、これらの関数は EOF または WEOF を返し、errno を EINVAL に設定します。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
putc ルーチンは、出力 stream の現在位置に 1 つの文字 c を書き込みます。 任意の整数を putc に渡すことができますが、下位 8 ビットのみが書き込まれます。 putchar ルーチンは putc( c**,stdout)** と同じです。 各ルーチンでは、読み取りエラーが発生すると、ストリームのエラー インジケーターが設定されます。 putc と putchar はそれぞれ、fputc と _fputchar に似ていますが、関数およびマクロとして実装されます (「関数とマクロの使い分け」を参照)。 putwc、および putwchar は、それぞれ、putc、および putchar のワイド文字バージョンです。 ストリームが ANSI モードで開かれている場合、putwc と putc の動作は同じになります。 putc では、UNICODE ストリームへの出力はサポートされていません。
_nolock サフィックスが付いているバージョンは同じものですが、他のスレッドによる干渉から保護されない点が異なります。 詳細については、「_putc_nolock、_putwc_nolock」を参照してください。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE & _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
putc |
<stdio.h> |
putwc |
<stdio.h> または <wchar.h> |
コンソールは、Windows ストア アプリではサポートされていません。 コンソール (stdin、stdout、および stderr) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって Windows ストア アプリで使用する前に、リダイレクトする必要があります。 互換性の詳細については、「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
// crt_putc.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/
#include <stdio.h>
int main( void )
{
FILE *stream;
char *p, buffer[] = "This is the line of output\n";
int ch;
ch = 0;
/* Make standard out the stream and write to it. */
stream = stdout;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putc( *p, stream );
}
出力
This is the line of output