putchar、putwchar
標準出力に文字を記述します。
int putchar(
int c
);
wint_t putwchar(
wchar_t c
);
パラメーター
- c
書き込む文字。
戻り値
書き込まれた文字を返します。エラーまたはファイルの終端状態を示すには、putc と putchar はを返します EOF; putwc と putwchar を返します WEOF。4 つすべてのルーチンでは、エラーを確認するために [ferror] かを feof またはファイルの終端使用します。渡られたら streamの null ポインターは パラメーターの検証に説明されているように、これらの関数は無効なパラメーターの例外を生成します。実行の継続が許可された場合、これらは EINVALに EOF か WEOF と同様に errno 返します。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
putc ルーチンは、現在位置に出力 stream に一つの文字 c を書き込みます。任意の整数でも putcに渡すことができますが、下限 8 の bit のみ書き込まれます。putchar ルーチンは **putc(c,stdout )**と同じものです。各ルーチンでは、読み取りエラーが発生すると、エラー ストリームの矢印が設定されます。putc と putchar は fputc と _fputcharに似ていますが、各値は、関数とマクロとして実装されます 関数とマクロの使い分け (を参照)。putwc と putwchar は putc と putcharのワイド文字バージョン、それぞれです。
_nolock のサフィックスのバージョンは同じですが、他のスレッドによって干渉から保護されません。これらは、他のスレッドをロックするオーバーヘッドを生じるため、処理速度があります。呼び出し元の範囲のハンドルが既に分離を使用したシングルスレッド アプリケーションなどのスレッド セーフなコンテキストでのみこれらの関数を使用します。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
putchar |
<stdio.h> |
putwchar |
<stdio.h> または <wchar.h> |
コンソールは Windows ストア の apps ではサポートされていません。コンソール、stdin、stdout、および stderrに関連付けられている標準ストリームのハンドルは C のランタイム関数が Windows ストア の apps で使用する前にをリダイレクトする必要があります。互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
// crt_putchar.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;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putchar( *p );
}
出力
This is the line of output