putc, putwc
Zapisuje znak do strumienia.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parametry
c
Znak do wpisania.stream
Wskaźnik do struktury FILE.
Wartość zwracana
Zwraca zapis znaku.Aby wskazać błąd lub warunek końca pliku putc i putchar zwrot EOF; putwc i putwchar zwrot WEOF.Dla wszystkich czterech procedur, użyj ferror lub feof, aby sprawdzić pod kątem występowania błędu lub końca pliku.Jeśli przekazywany jest pusty wskaźnik dla stream, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, te funkcje zwracają EOF lub WEOF i ustawiają errno jako EINVAL.
Aby uzyskać więcej informacji na temat tych i innych kodów błędu, zobacz _doserrno, errno, _sys_errlist, and _sys_nerr.
Uwagi
putc rutynowo pisze pojedynczy znak c w wyniku stream w bieżącym położeniu.Każda liczba całkowita może być przekazywane do putc, ale tylko niższe 8 bitów jest zapisywane.putchar rutyna jest identyczna z **putc(**c ,stdout).Dla każdej procedury, jeśli wystąpi błąd odczytu, zostanie ustawiony wskaźnik błędu dla strumienia.putc i putchar są podobne do fputc i _fputchar, odpowiednio, ale są implementowane zarówno funkcje, jak makra (zobacz wybór między funkcjami i makrami).putwc i putwchar są wersjami szerokich znaków putc i putchar, odpowiednio.putwc i putc zachowują się identycznie, jeżeli strumień jest otwarty w trybie ANSI.putc aktualnie nie obsługuje danych wyjściowych w strumieniu UNICODE.
Wersje przyrostka nolock są identyczne poza tym, że nie są chronione przed ingerencją przez inne wątki.Aby uzyskać więcej informacji, zobacz _putc_nolock _putwc_nolock.
Rutynowe mapowania zwykłego tekstu
Procedura Tchar.h |
_UNICODE & _MBCS nie zdefiniowano |
_MBCS zdefiniowano |
_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 Windows Store.Standardowe uchwyty strumienia powiązane z konsolą—stdin, stdout, i stderr—muszą zostać przekierowane zanim będą wykorzystane przez funkcje środowiska uruchomieniowego C w aplikacjach Windows Store.Dodatkowe informacje o zgodności – zobacz: Zgodność.
Biblioteki
Wszystkie wersje Bibliotek uruchomieniowych 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 );
}
Dane wyjściowe
This is the line of output