putc, putwcputc, putwc

Zapisuje znak w strumieniu.Writes a character to a stream.

SkładniaSyntax

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

ParametryParameters

sc
Znak do zapisania.Character to be written.

produkcyjnestream
Wskaźnik do struktury pliku .Pointer to FILE structure.

Wartość zwracanaReturn Value

Zwraca znak zapisany.Returns the character written. Aby wskazać błąd lub koniec pliku, putc i putchar Return EOF; putwc i putwchar zwracają WEOF.To indicate an error or end-of-file condition, putc and putchar return EOF; putwc and putwchar return WEOF. Dla wszystkich czterech procedur Użyj obiektu powołującego lub feof , aby sprawdzić, czy wystąpił błąd lub koniec pliku.For all four routines, use ferror or feof to check for an error or end of file. Jeśli przeszedł wskaźnik o wartości null dla strumienia, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w walidacji parametru.If passed a null pointer for stream, the invalid parameter handler is invoked, as described in Parameter Validation. Jeśli wykonanie może być kontynuowane, te funkcje zwracają EOF lub WEOF i ustawiają errno na EINVAL.If execution is allowed to continue, these functions return EOF or WEOF and set errno to EINVAL.

Aby uzyskać więcej informacji na temat tych i innych kodów błędów, zobacz _doserrno, errno, _sys_errlist i _sys_nerr .See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

UwagiRemarks

Procedura putc zapisuje pojedynczy znak c do strumienia wyjściowego w bieżącym położeniu.The putc routine writes the single character c to the output stream at the current position. Dowolną liczbę całkowitą można przesłać do putc, ale zapisywane są tylko dolne 8 bitów.Any integer can be passed to putc, but only the lower 8 bits are written. Procedura putchar jest taka sama jak putc( c, stdout ) .The putchar routine is identical to putc( c, stdout ). Dla każdej procedury, jeśli wystąpi błąd odczytu, zostanie ustawiony wskaźnik błędu dla strumienia.For each routine, if a read error occurs, the error indicator for the stream is set. putc i putchar są podobne do fputc i _fputchar, ale są implementowane zarówno jako funkcje, jak i jako makra (zobacz wybór między funkcjami i makrami).putc and putchar are similar to fputc and _fputchar, respectively, but are implemented both as functions and as macros (see Choosing Between Functions and Macros). putwc i putwchar są odpowiednio wersjami putc i putchar.putwc and putwchar are wide-character versions of putc and putchar, respectively. putwc i putc zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI.putwc and putc behave identically if the stream is opened in ANSI mode. putc obecnie nie obsługuje danych wyjściowych w strumieniu Unicode.putc doesn't currently support output into a UNICODE stream.

Wersje z sufiksem _nolock są identyczne, z tą różnicą, że nie są chronione przed ingerencją przez inne wątki.The versions with the _nolock suffix are identical except that they are not protected from interference by other threads. Aby uzyskać więcej informacji, zobacz _putc_nolock, _putwc_nolock.For more information, see _putc_nolock, _putwc_nolock.

Domyślnie globalny stan tej funkcji jest objęty zakresem aplikacji.By default, this function's global state is scoped to the application. Aby to zmienić, zobacz stan globalny w CRT.To change this, see Global state in the CRT.

Mapowania procedur zwykłego tekstuGeneric-Text Routine Mappings

Procedura TCHAR.HTCHAR.H routine Nie zdefiniowano _MBCS _UNICODE &_UNICODE & _MBCS not defined _MBCS zdefiniowano_MBCS defined _UNICODE zdefiniowano_UNICODE defined
_puttc_puttc putcputc putcputc putwcputwc

WymaganiaRequirements

ProceduraRoutine Wymagany nagłówekRequired header
putcputc <stdio.h>
putwcputwc <stdio.h> lub <wchar.h><stdio.h> or <wchar.h>

Konsola nie jest obsługiwana w aplikacjach platforma uniwersalna systemu Windows (platformy UWP).The console is not supported in Universal Windows Platform (UWP) apps. Standardowe uchwyty strumienia, które są skojarzone z konsolą, stdin, stdout i stderr, muszą zostać przekierowane przed użyciem funkcji języka C w aplikacjach platformy UWP.The standard stream handles that are associated with the console, stdin, stdout, and stderr, must be redirected before C run-time functions can use them in UWP apps. Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodność.For additional compatibility information, see Compatibility.

BibliotekiLibraries

Wszystkie wersje bibliotek uruchomieniowych języka C.All versions of the C run-time libraries.

PrzykładExample

// 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ścioweOutput

This is the line of output

Zobacz teżSee also

We/Wy strumieniaStream I/O
fputc, fputwcfputc, fputwc
getc, getwcgetc, getwc