putchar, putwchar

öğesine stdoutbir karakter yazar.

Sözdizimi

int putchar(
   int c
);
wint_t putwchar(
   wchar_t c
);

Parametreler

c
Yazılacak karakter.

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, bu işlevler Parametre doğrulamasında açıklandığı gibi geçersiz bir parametre özel durumu oluşturur. Yürütmenin devam etmesi için izin verilirse, 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.

Soneki olan _nolock sürümler, diğer iş parçacıkları tarafından müdahaleye karşı korunmamaları dışında aynıdır. Diğer iş parçacıklarını kilitleme yüküne neden olmadığından daha hızlı olabilirler. Bu işlevleri yalnızca tek iş parçacıklı uygulamalar gibi iş parçacığı güvenli bağlamlarda veya çağıran kapsamın iş parçacığı yalıtımını zaten işlediği durumlarda kullanın.

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
_puttchar	putchar	putchar	putwchar

Gereksinimler

Yordam	Gerekli başlık
putchar	<stdio.h>
putwchar	<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_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 );
}

Çıktı

This is the line of output

Ayrıca bkz.

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