fputc, fputwc
Akışa bir karakter yazar.
Sözdizimi
int fputc(
int c,
FILE *stream
);
wint_t fputwc(
wchar_t c,
FILE *stream
);
Parametreler
c
Yazılacak karakter.
stream
Yapı işaretçisi FILE .
Dönüş değeri
Bu işlevlerin her biri yazılan karakteri döndürür. için fputcdeğerinin EOF dönüş değeri bir hatayı gösterir. için fputwcdeğerinin WEOF dönüş değeri bir hatayı gösterir. ise stream NULL, bu işlevler Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, geri döner EOF ve olarak EINVALayarlanırerrno.
İade kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.
Açıklamalar
Bu işlevlerin her biri, tanımlanmışsa, ilişkili dosya konumu göstergesi tarafından belirtilen konumdaki bir dosyaya tek karakteri c yazar. İşlevler göstergeyi uygun şekilde ilerletir. ve fputwciçindefputc, dosya ile streamilişkilendirilir. Dosya, istekleri konumlandırmayı desteklemiyorsa veya ekleme modunda açıldıysa, karakter akışın sonuna eklenir.
Akış ANSI modunda açıldığında iki işlev aynı şekilde davranır. fputc ş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._fputwc_nolock_fputc_nolock .
Rutine özgü açıklamalar takip eder.
| Yordam | Açıklamalar |
|---|---|
fputc |
ile putceşdeğerdir, ancak işlev ve makro olarak değil yalnızca işlev olarak uygulanır. |
fputwc |
'nin geniş karakterli fputcsürümü. c Sırasıyla metin modunda veya ikili modda açıldığında çok baytlı veya geniş bir karakter stream olarak yazar. |
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 |
|---|---|---|---|
_fputtc |
fputc |
fputc |
fputwc |
Gereksinimler
| İşlev | Gerekli başlık |
|---|---|
fputc |
<stdio.h> |
fputwc |
<stdio.h> veya <wchar.h> |
Konsol Evrensel Windows Platformu (UWP) uygulamalarında desteklenmez. C çalışma zamanı işlevlerinin bunları UWP uygulamalarında kullanabilmesi için konsolla ilişkilendirilmiş standart akış tanıtıcılarının (stdinstdout, ve stderr) yeniden yönlendirilmesi gerekir. Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Örnek
// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr1[] = "This is a test of fputc!!\n";
char *p;
// Print line to stream using fputc.
p = strptr1;
while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;
}
This is a test of fputc!!