putc, putwc
Bir akışa bir karakter yazar.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parametreler
c
Yazılacak karakter.stream
DOSYA yapı işaretçisi.
Dönüş Değeri
Yazılan karakteri döndürür.Bir hata veya dosya sonu koşulu belirtmek için putc ve putchar geri EOF; putwc ve putwchar, WEOF getirir.Dört rutinin tümü için, hata veya dosya sonunu denetlemek üzere ferror veya feof öğesini kullanın.stream için bir null işaretçi iletilirse, Parametre Doğrulama içinde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.Yürütmenin devam etmesine izin verilirse, bu işlevler EOF veya WEOF döndürür ve errno öğesi EINVAL olarak ayarlanır.
Bunlar ve diğer hata kodları hakkında daha fazla bilgi için bkz. _doserrno, errno, _sys_errlist ve _sys_nerr
Notlar
putc yordamı tek bir c karakterini stream çıktısına mevcut konumda yazar.Herhangi bir tamsayı putc öğesine geçirilir, ancak yalnızca alt 8 bit yazılır.putchar yordamı putc( c**,** stdout ) ile eşdeğerdir.Her bir rutin için, bir okuma hatası oluşursa, akış için hata göstergesi ayarlanır.putc ve putchar, sırasıyla fputc ve _fputchar'a benzer; ancak hem işlev hem de makro olarak uygulanırlar (bkz. İşlevlerle Makrolar Arasında Seçim Yapma).putwc ve putwchar, sırasıyla putc ve putchar'ın geniş karakterli sürümleridir.putwc ve putc, akış ANSI modunda açıldığında aynı şekilde çalışır.putc şu anda UNICODE akışına çıkış alınmasını desteklemez.
_nolock sonekine sahip sürümler, başka iş parçacıklarıyla engellemeden korunmamaları dışında aynıdır.Daha fazla bilgi için bkz. _putc_nolock, _putwc_nolock.
Genel Metin Yordam Eşleşmeleri
TCHAR.H yordamı |
_UNICODE & _MBCS tanımlanmamış |
_MBCS tanımlanmış |
_UNICODE tanımlanmış |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
Gereksinimler
Yordam |
Gerekli başlık |
|---|---|
putc |
<stdio.h> |
putwc |
<stdio.h> or <wchar.h> |
Konsol Windows Mağazası uygulamalarında desteklenmiyor.stdin, stdout ve stderr konsolları ile ilişkili standart akış işleyicileri, C çalışma zamanı işlevleri bunları Windows Mağazası uygulamalarında kullanmadan önce yeniden yönlendirilmelidir.Ek uyumluluk bilgileri için bkz. Uyumluluk.
Kitaplıklar
C çalışma zamanı kitaplıklarının çoklu iş parçacığı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