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 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, 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. İş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