Sdílet prostřednictvím


putc putwc

Zadejte znak do datového proudu.

int putc(
   int c,
   FILE *stream 
);
wint_t putwc(
   wchar_t c,
   FILE *stream 
);

Parametry

  • c
    Znak, který má být zapsán.

  • stream
    Ukazatel na soubor struktury.

Vrácená hodnota

Vrátí znak zapsán.K označení chyby nebo podmínku ukončení souboru putc a putchar vrátit EOF; putwcand putwchar return WEOF.Všechny čtyři rutin, pomocí ferror nebo feof pro kontrolu chyb nebo konec souboru.Pokud je předán nulový ukazatel stream, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, tyto funkce vracejí EOF nebo WEOF 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

putc Rutina zapíše jeden znak c do výstupu stream na aktuální pozici.Libovolné celé číslo může být předán do putc, ale jsou zapsány pouze nižší 8 bitů.The putchar routine is identical to putc(c,stdout ).Každý rutiny dojde-li k oznámení o chybě, je nastavena indikátor chyby pro datový proud.putca putchar jsou podobné fputc a _fputchar, resp., ale jsou implementovány jako funkce i makra (viz Volba mezi funkce a makra).putwca putwchar jsou verze širokého znaku putc a putchar, respektive.putwca putc chovaly stejně jako v případě, že datový proud je otevřen v režimu ANSI.putcnepodporuje aktuálně 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 _putc_nolock, _putwc_nolock.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h

_UNICODE & _MBCS není definováno

_MBCS, definice

_UNICODE definována

_puttc

putc

putc

putwc

Požadavky

Byla zahájena rutina

Požadované záhlaví

putc

<stdio.h>

putwc

<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.

Knihovny

Všechny verze C run-time libraries.

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

Ekvivalent v rozhraní .NET Framework

Viz také

Referenční dokumentace

Proud I/O

fputc fputwc

getc getwc