putc, putwc
Wpisz znak do strumienia.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parametry
c
Znak do zapisania.stream
Wskaźnik, aby pliku struktury.
Wartość zwracana
Zwraca znak napisane.Aby wskazać błąd lub stanu końca pliku, putc i putchar zwrotu EOF; putwcand putwchar return WEOF.Dla wszystkich czterech procedur, użyj ferror lub feof Aby sprawdzić, czy komunikat o błędzie lub koniec pliku.Jeżeli nie przekazano pusty wskaźnik stream, program obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje te zwracają EOF lub WEOF i errno do EINVAL.
Zobacz _doserrno, errno, _sys_errlist i _sys_nerr więcej informacji na temat tych i innych kodów błędów.
Uwagi
putc Rutynowych pisze pojedynczy znak c w wyniku stream w bieżącym położeniu.Dowolna liczba całkowita, mogą być przekazywane do putc, ale są napisane niższe 8 bitów.The putchar routine is identical to putc(c,stdout ).Dla każdego rutynowych Jeśli wystąpi błąd odczytu, ustaw wskaźnik błędu dla strumienia.putci putchar są podobne do fputc i _fputchar, odpowiednio, ale są implementowane zarówno funkcje, jak makra (zobacz Wybór między funkcje i makra).putwci putwchar są wersje szerokich znaków putc i putchar, odpowiednio.putwci putc zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI.putcaktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.
Wersje z _nolock sufiks są identyczne z tym, że nie są zabezpieczone przed ingerencją przez inne wątki.Aby uzyskać więcej informacji, zobacz _putc_nolock, _putwc_nolock.
Tekst rodzajowy rutynowych mapowania
TCHAR.Rozpoczęto wykonywanie procedury h |
_UNICODE & _MBCS nie zdefiniowany |
_MBCS, definicja |
_UNICODE, definicja |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
|---|---|
putc |
<stdio.h> |
putwc |
<stdio.h> lub <wchar.h> |
Konsola nie jest obsługiwana w Windows Store aplikacji.Związanych z konsolą, dojścia do strumienia standard stdin, stdout, i stderr, muszą być przeniesione, aby funkcje uruchomieniowej C mogą być użyte w Windows Store aplikacji.Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.
Biblioteki
Wszystkie wersje programu biblioteki uruchomieniowej 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