Sdílet prostřednictvím

fputc, fputwc

  • Článek

Zapíše znak do datového proudu.

Syntaxe

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

Parametry

c
Znak, který se má napsat.

stream
Ukazatel na FILE strukturu.

Vrácená hodnota

Každá z těchto funkcí vrátí znak napsaný. Návratová fputcEOF hodnota indikuje chybu. Návratová fputwcWEOF hodnota indikuje chybu. Pokud stream ano NULL, tyto funkce vyvolávají neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, vrátí EOF a nastaví errno na EINVAL.

Další informace o návratových kódech naleznete v tématu errno, _doserrno, _sys_errlista _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, pokud je definován. Funkce podle potřeby indikátor přechádí. In fputc a fputwc, soubor je přidružen stream. Pokud soubor nepodporuje umístění požadavků nebo byl otevřen v režimu připojení, připojí se znak na konec datového proudu.

Dvě funkce se chovají stejně, pokud je datový proud otevřen v režimu ANSI. fputc v současné době nepodporuje výstup do datového 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 tématu_fputc_nolock_fputwc_nolock .

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

Rutina Poznámky
fputc Ekvivalent funkce putc, ale implementovaný pouze jako funkce, nikoli jako funkce a makro.
fputwc Širokoznační verze .fputc Při c otevření v textovém režimu nebo v binárním režimu se zapíše jako vícebajtový znak nebo široký znak stream .

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina TCHAR.H _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_fputtc fputc fputc fputwc

Požadavky

Function Požadovaný hlavičkový soubor
fputc <stdio.h>
fputwc <stdio.h> nebo <wchar.h>

Konzola není podporována v aplikacích pro Univerzální platforma Windows (UPW). Standardní stream zpracovává, které jsou přidružené ke konzole –stdinstdout a stderr– musí být přesměrovány, aby je funkce běhu jazyka C mohly používat v aplikacích pro UPW. Další informace o kompatibilitě najdete 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 ) ;

}

This is a test of fputc!!

Viz také

Vstupně-výstupní operace streamu
fgetc, fgetwc
putc, putwc