putc, putwc
Zapíše znak do proudu.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parametry
c
Znak k zapsání.stream
Ukazatel na strukturu SOUBOR.
Vrácená hodnota
Vrátí zapsaný znak.K označení chyby nebo stavu konce souboru putc a putchar vrací EOF; putwc a putwchar vrací WEOF.Pro všechny čtyři rutiny použijte ferror nebo feof pro kontrolu chyby nebo konce souboru.Pokud je pro stream předán ukazatel s hodnotou null, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, vrátí tyto funkce EOF nebo WEOF 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
Rutina putc zapíše jeden znak c na výstup stream na aktuální pozici.Libovolné celé číslo, které lze předat do putc, ale zapsány jsou pouze nižší 8bity.Rutina putchar je shodná s putc ( c**,** stdout).Pokud dojde k chybě čtení, pro každou rutinu je nastaven indikátor chyby pro datový proud.putc a putchar jsou podobné jako fputc a _fputchar, ale jsou implementovány jako funkce i makra (viz Volba mezi funkcemi a makry).putwc a putwchar jsou širokoznaké verze putc a putchar.putwc a putc se chovají stejně jako v případě, že datový proud je otevřen v režimu ANSI.putc 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 tématu _putc_nolock _putwc_nolock.
Rutinní mapování obecného textu
Rutina TCHAR.H |
_UNICODE & _MBCS není definováno |
_MBCS definováno |
_UNICODE definováno |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
Požadavky
Rutina |
Požadované záhlaví |
|---|---|
putc |
<stdio.h> |
putwc |
<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.
Knihovny
Všechny verze běhových knihoven C.
Příklad
// crt_putc.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;
/* Make standard out the stream and write to it. */
stream = stdout;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putc( *p, stream );
}
Výsledek
This is the line of output