putc, putwc

Akışa bir karakter yazar.

Sözdizimi

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

Parametreler

c
Yazılacak karakter.

stream
Yapı işaretçisi FILE .

Dönüş değeri

Yazılan karakteri döndürür. Bir hatayı veya dosya sonu koşulunu belirtmek için ve putc döndürerek putwcharEOFputwc döndür.WEOFputchar Dört yordamın tümü için veya feof komutunu kullanarak ferror bir hata veya dosya sonu olup olmadığını denetleyin. için streamnull işaretçi geçirilirse, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler veya WEOFdöndürür EOF ve olarak EINVALayarlanırerrno.

İade kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

yordamı, putc çıkışa stream geçerli konumdaki tek karakteri c yazar. Herhangi bir tamsayı öğesine putcgeçirilebilir, ancak yalnızca alt 8 bit yazılır. Yordamı putchar ile aynıdır putc( c, stdout ). Her yordam için bir okuma hatası oluşursa akış için hata göstergesi ayarlanır. putcve putchar sırasıyla ve _fputcharile fputc benzerdir, ancak hem işlev hem de makro olarak uygulanır (bkz. işlevler ve makrolar arasında seçim yapmak için Öneriler). putwcve putwchar sırasıyla ve putchar'nin putc geniş karakterli sürümleridir. putwc ve putc akış ANSI modunda açıldığında aynı şekilde davranır. putc şu anda UNICODE akışına çıkışı desteklemez.

Soneki olan _nolock sürümler, diğer iş parçacıkları tarafından müdahaleye karşı korunmamaları dışında aynıdır. Daha fazla bilgi için bkz . _putc_nolock, _putwc_nolock.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_puttc	putc	putc	putwc

Gereksinimler

Yordam	Gerekli başlık
putc	<stdio.h>
putwc	<stdio.h> veya <wchar.h>

Konsol Evrensel Windows Platformu (UWP) uygulamalarında desteklenmez. C çalışma zamanı işlevlerinin UWP uygulamalarında kullanabilmesi için önce konsolu stdin, , stdoutve stderrile ilişkilendirilmiş standart akış tanıtıcılarının yeniden yönlendirilmesi gerekir. Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Kitaplıklar

C çalışma zamanı kitaplıklarının tüm sürümleri.

Örnek

// 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 );
}

Çıktı

This is the line of output

Ayrıca bkz.

Akış G/Ç
fputc, fputwc
getc, getwc