fputc, fputwc

Artykuł
06/09/2015

Zapisuje znak do strumienia.

int fputc(
   int c,
   FILE *stream 
);
wint_t fputwc(
   wchar_t c,
   FILE *stream 
);

Parametry

c
Znak do wpisania.
stream
Wskaźnik na FILE strukturę.

Wartość zwracana

Każda z tych funkcji zwraca znak napisany.W przypadku fputc, zwracana wartość wynosząca EOF wskazuje na błąd.W przypadku fputwc, zwracana wartość wynosząca WEOF wskazuje na błąd.Jeśli stream ma wartość NULL, te funkcje wywołują procedurę obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, zwracają one EOF 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

Każda z tych funkcji pisze pojedynczy znak c do pliku w położeniu wskazanym przez wskaźnik położenia skojarzonego pliku (jeżeli zdefiniowano) i posuwa odpowiednio wskaźnik.W odniesieniu do fputc i fputwc, plik jest skojarzony z stream*.* Jeśli plik nie może obsłużyć żądania pozycjonowania lub został otwarty w trybie dołączania, znak jest dołączany na końcu strumienia.

Te dwie funkcje zachowują się identycznie, jeżeli strumień jest otwarty w trybie ANSI.fputc 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_fputc_nolock, _fputwc_nolock.

Wykonaj rutynowe specyficzne uwagi.

Procedura	Uwagi
fputc	Równoważne z putc, ale realizowane tylko jako funkcja, a nie jako funkcja i makra.
fputwc	Wersja szerokiego znaku fputc.Zapisuje c jako znak wielobajtowy lub znak dwubajtowy ze względu an to, czy stream jest otwierany w trybie tekstu lub w trybie binarnym.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE & _MBCS nie zdefiniowano	_MBCS zdefiniowano	_UNICODE zdefiniowany
_fputtc	fputc	fputc	fputwc

Wymagania

Funkcja	Wymagany nagłówek
fputc	<stdio.h>
fputwc	<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ść.

Przykład

// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
 

#include <stdio.h>

int main( void )
{
   char strptr1[] = "This is a test of fputc!!\n";
   char *p;

   // Print line to stream using fputc. 
   p = strptr1;
   while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;

}