putc, putwc

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

構文

int putc(
   int c,
   FILE *stream
);
wint_t putwc(
   wchar_t c,
   FILE *stream
);

パラメーター

c
書き込む文字。

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

戻り値

書き込まれた文字を返します。 エラーまたはファイルの終わりの条件を示し、putc; putwc を返EOFしてputwcharputchar返しますWEOF。 4 つのルーチンすべてについて、ferrorエラーまたはfeofファイルの終わりにチェックします。 null ポインターstreamを渡した場合、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行を続行できる場合、これらの関数は戻りEOF値または WEOF.errnoEINVAL.

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

解説

putc ルーチンは、出力 c の現在位置に 1 つの文字 stream を書き込みます。 任意の整数を putc に渡すことができますが、下位 8 ビットのみが書き込まれます。 ルーチンは putchar 次と同じです putc( c, stdout )。 各ルーチンでは、読み取りエラーが発生すると、ストリームのエラー インジケーターが設定されます。 putcはputchar、それぞれ似ています_fputcharfputcが、関数とマクロの両方として実装されます (関数とマクロの選択については、おすすめを参照してください)。 putwc、および putwchar は、それぞれ、putc、および putchar のワイド文字バージョンです。 ストリームが ANSI モードで開かれている場合、putwc と putc の動作は同じになります。 putc では、UNICODE ストリームへの出力はサポートされていません。

サフィックス付きのバージョンは、他の _nolock スレッドによる干渉から保護されない点が異なります。 詳細については、「_putc_nolock、_putwc_nolock」をご覧ください。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

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

TCHAR.H のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_puttc	putc	putc	putwc

必要条件

ルーチンによって返される値	必須ヘッダー
putc	<stdio.h>
putwc	<stdio.h> または <wchar.h>

ユニバーサル Windows プラットフォーム (UWP) アプリではコンソールがサポートされていません。 コンソール (stdin、stdout、stderr) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって UWP アプリで使用される前に、リダイレクトする必要があります。 互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

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

関連項目

ストリーム入出力
fputc, fputwc
getc, getwc