fputc, fputwc

Článek
06/09/2015

Zapíše znak do proudu.

int fputc(
   int c,
   FILE *stream 
);
wint_t fputwc(
   wchar_t c,
   FILE *stream 
);

Parametry

c
Znak k zapsání.
stream
Ukazatel na strukturu FILE.

Vrácená hodnota

Každá z těchto funkcí vrací napsaný znak.Pro fputc vrácená hodnota EOF označuje chybu.Pro fputwc, vrácená hodnota WEOF označuje chybu.Pokud stream je NULL, tyto funkce vyvolají neplatnou obslužnou rutinu parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, vrátí funkce EOF a nastaví errno na EINVAL.

Další informace o těchto a dalších chybových kódech viz _doserrno, errno, _sys_errlist, and _sys_nerr.

Poznámky

Každá z těchto funkcí zapíše jeden znak c do souboru na pozici označenou indikátorem pozice přidruženého souboru (je-li definován) a posune indikátor podle potřeby.V případě fputc a fputwc je soubor spojen s stream*.* Pokud soubor nemůže podporovat požadavky na umístění nebo byl otevřena v režimu přidání, znak je připojen na konec datového proudu.

Tyto dvě funkce se chovají stejně jako v případě, že datový proud je otevřen v režimu ANSI.fputc aktuálně nepodporuje výstup v proudu UNICODE.

Verze s příponou _nolock jsou shodné s tím rozdílem, že nejsou chráněny před rušením jinými vlákny.Další informace naleznete v části_fputc_nolock, _fputwc_nolock.

Následují poznámky specifické pro rutinu.

Rutina	Poznámky
fputc	Ekvivalentní s putc, ale implementována pouze jako funkce, nikoli jako funkce a makro.
fputwc	Širokoznaká verze fputc.Zapíše c jako vícebajtový znak nebo široký znak podle toho, zda je stream otevřen v textovém nebo binárním režimu.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_fputtc	fputc	fputc	fputwc

Požadavky

Funkce	Požadované záhlaví
fputc	<stdio.h>
fputwc	<stdio.h> nebo <wchar.h>

Konzola není v aplikacích Windows Store podporována.Standardní datový proud popisovačů, které jsou spojeny s konzolou – stdin, stdout a stderr, musí být přesměrován před použitím funkcí jazyka C run-time je v aplikacích Windows Store.Další informace o kompatibilitě naleznete v tématu Kompatibilita.

Příklad

// 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 ) ;

}