putchar, putwchar
Zapíše znak do stdout.
int putchar(
int c
);
wint_t putwchar(
wchar_t c
);
Parametry
- c
Znak k zapsání.
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.Byl-li předán ukazatel null pro stream, tyto funkce generují výjimku neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, vrátí 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.
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.Mohou být rychlejší, neboť nepřidávají režii uzamykáním ostatních vláken.Tyto funkce používejte pouze v kontextech bezpečných na vlákna, jako jsou aplikace s jedním vláknem nebo pokud volající obor již zpracovává izolaci vláken.
Rutinní mapování obecného textu
Rutina TCHAR.H |
_UNICODE & _MBCS není definováno |
_MBCS definováno |
_UNICODE definováno |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
Požadavky
Rutina |
Požadované záhlaví |
|---|---|
putchar |
<stdio.h> |
putwchar |
<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_putchar.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;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putchar( *p );
}
Výsledek
This is the line of output