次の方法で共有


putc、putwc

更新 : 2007 年 11 月

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

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

パラメータ

  • c
    書き込む文字。

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

戻り値

書き込まれた文字を返します。エラーが発生した場合や EOF (end-of-file) が検出された場合は、putcputcharEOFputwcputwcharWEOF を返します。エラーまたは EOF を調べるには、ferror または feof を使用します。stream に null ポインタが渡された場合は、「パラメータの検証」に説明されているように、無効なパラメータ ハンドラが呼び出されます。実行の継続が許可された場合、これらの関数は EOF または WEOF を返し、errnoEINVAL に設定します。

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

解説

putc ルーチンは、単一の文字 c を stream に指定されている出力ストリームの現在位置に書き込みます。putc ルーチンには任意の整数を渡せますが、書き込まれるのは下位 8 ビットだけです。putchar ルーチンは、putc(c,stdout ) と同じです。各ルーチンでは、読み取りエラーが発生した場合、ストリームのエラー インジケータが設定されます。putc および putchar は、それぞれ fputc および _fputchar に似ていますが、関数とマクロの両方として実装されています (「関数またはマクロの選択に関する推奨事項」を参照)。ワイド文字を扱う場合は、putc および putchar ではなく、それぞれ putwc および putwchar を使用します。ストリームが 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>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

ライブラリ

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

.NET Framework の相当するアイテム

参照

参照

ストリーム入出力

fputc、fputwc

getc、getwc