putc, putwc

Menulis karakter ke aliran.

Sintaks

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

Parameter

c
Karakter yang akan ditulis.

stream
Penunjuk ke FILE struktur.

Nilai hasil

Mengembalikan karakter yang ditulis. Untuk menunjukkan kesalahan atau kondisi akhir file, putc dan putchar kembalikan EOF; putwc dan putwchar kembalikan WEOF. Untuk keempat rutinitas, gunakan ferror atau feof untuk memeriksa kesalahan atau akhir file. Jika melewati penunjuk null untuk stream, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi-fungsi ini mengembalikan EOF atau WEOF, dan diatur errno ke EINVAL.

Untuk informasi selengkapnya tentang kode pengembalian, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Rutinitas putc menulis karakter c tunggal ke output stream pada posisi saat ini. Bilangan bulat apa pun dapat diteruskan ke putc, tetapi hanya 8 bit yang lebih rendah yang ditulis. Rutinitasnya putchar identik dengan putc( c, stdout ). Untuk setiap rutinitas, jika terjadi kesalahan baca, indikator kesalahan untuk aliran diatur. putcdan putchar mirip dengan dan _fputchar, masing-masing, tetapi diimplementasikan baik sebagai fungsi maupun sebagai makro (lihat Rekomendasi untuk memilih antara fungsi dan makrofputc). putwcdan putwchar masing-masing adalah versi karakter lebar dan putcharputc , . putwc dan putc bersifat identik jika aliran dibuka dalam mode ANSI. putc saat ini tidak mendukung output ke dalam aliran UNICODE.

Versi dengan akhiran _nolock identik kecuali tidak dilindungi dari gangguan oleh utas lain. Untuk informasi selengkapnya, lihat _putc_nolock, _putwc_nolock.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

TCHAR. Rutinitas H	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_puttc	putc	putc	putwc

Persyaratan

Rutin	Header yang diperlukan
putc	<stdio.h>
putwc	<stdio.h> atau <wchar.h>

Konsol tidak didukung di aplikasi Platform Windows Universal (UWP). Handel aliran standar yang terkait dengan konsol, , stdin, stdoutdan stderr, harus dialihkan sebelum fungsi run-time C dapat menggunakannya di aplikasi UWP. Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Contoh

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

Output

This is the line of output

Lihat juga

Streaming I/O
fputc, fputwc
getc, getwc