fputc fputwc

Článek
03/26/2013

Znak se zapíše do datového proudu.

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

Parametry

c
Znak, který má být zapsán.
stream
Ukazatel na FILE struktury.

Vrácená hodnota

Každá z těchto funkcí vrací napsanému znaku.Pro fputc, vrácená hodnota EOF označuje chybu.Pro fputwc, vrácená hodnota WEOF označuje chybu.Pokud stream je NULL, tyto funkce vyvolat obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, vracejí EOF a errno na EINVAL.

Viz _doserrno, kód chyby, _sys_errlist a _sys_nerr Další informace o těchto a jiných kódy chyb.

Poznámky

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

Dvě funkce chovaly stejně jako v případě, že datový proud je otevřen v režimu ANSI.fputcaktuálně nepodporuje výstup do proudu UNICODE.

Verze s _nolock přípony jsou shodné s tím rozdílem, že nejsou chráněny před rušení jiných podprocesů.Další informace naleznete v tématu_fputc_nolock _fputwc_nolock.

Postupujte podle specifických pro běžné poznámky.

Byla zahájena rutina	Poznámky
fputc	Rovnocenné putc, ale je implementována pouze jako funkce, nikoli jako funkce a makra.
fputwc	Verze širokého znaku fputc.Zapíše c jako vícebajtové znakové nebo širokého znaku podle zda stream je otevřen v režimu textu nebo binárním režimu.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_fputtc	fputc	fputc	fputwc

Požadavky

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

V konzole není podporována v Windows Store apps.Úchyty standardní datový proud přidružené konzoly, stdin, stdout, a stderr, musí být přesměrována před C run-time funkce lze využít v Windows Store apps.Další informace o kompatibilitě, viz Compatibility v úvodu.

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

}