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 putwchar EOFputwc 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. İş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