putc, putwc

Zapisuje znak w strumieniu.

Składnia

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

Parametry

c
Znak do zapisania.

stream
Wskaźnik do FILE struktury.

Wartość zwracana

Zwraca zapisany znak. Aby wskazać błąd lub warunek końca pliku, putc i putchar zwrócić EOFwartość ; putwc i putwchar zwrócić WEOFwartość . W przypadku wszystkich czterech procedur użyj polecenia ferror lub feof , aby sprawdzić błąd lub koniec pliku. Jeśli przekazano wskaźnik null dla streamparametru , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonanie jest dozwolone do kontynuowania, te funkcje zwracają EOF wartość lub WEOF, i ustaw wartość errno EINVAL.

Aby uzyskać więcej informacji na temat kodów zwracanych, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Rutyna putc zapisuje pojedynczy znak c w danych wyjściowych stream w bieżącym położeniu. Dowolna liczba całkowita może być przekazywana do putcmetody , ale zapisywane są tylko dolne 8 bitów. Ta rutyna jest identyczna putchar z procedurą putc( c, stdout ). W przypadku każdej procedury, jeśli wystąpi błąd odczytu, zostanie ustawiony wskaźnik błędu dla strumienia. putc i putchar są podobne odpowiednio do fputc i _fputchar, ale są implementowane zarówno jako funkcje, jak i jako makra (zobacz Zalecenia dotyczące wybierania między funkcjami i makrami). putwc i putwchar są odpowiednio wersjami putc znaków i putchar. putwc i putc zachowuje się identycznie, jeśli strumień jest otwarty w trybie ANSI. putc obecnie nie obsługuje danych wyjściowych do strumienia UNICODE.

Wersje z sufiksem _nolock są identyczne, z tą różnicą, że nie są chronione przed ingerencją innych wątków. Aby uzyskać więcej informacji, zobacz _putc_nolock, _putwc_nolock.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS zdefiniowany	_UNICODE zdefiniowany
_puttc	putc	putc	putwc

Wymagania

Procedura	Wymagany nagłówek
putc	<stdio.h>
putwc	<stdio.h> lub <wchar.h>

Konsola nie jest obsługiwana w aplikacjach platformy platforma uniwersalna systemu Windows (UWP). Standardowe dojścia strumienia skojarzone z konsolą programu stdin, stdouti i stderrmuszą zostać przekierowane, zanim funkcje czasu wykonywania języka C będą mogły ich używać w aplikacjach platformy UWP. Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka C.

Przykład

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

Wynik

This is the line of output

Zobacz też

We/Wy strumienia
fputc, fputwc
getc, getwc