putchar, putwchar

Menulis karakter ke stdout.

Sintaks

int putchar(
   int c
);
wint_t putwchar(
   wchar_t c
);

Parameter

c
Karakter yang akan ditulis.

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 pointer null untuk stream, fungsi-fungsi ini menghasilkan pengecualian parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, eksekusi akan kembali 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 , .

Versi dengan akhiran _nolock identik kecuali tidak dilindungi dari gangguan oleh utas lain. Mereka mungkin lebih cepat karena mereka tidak menimbulkan overhead penguncian utas lain. Gunakan fungsi-fungsi ini hanya dalam konteks aman utas seperti aplikasi utas tunggal atau di mana cakupan panggilan sudah menangani isolasi utas.

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
_puttchar	putchar	putchar	putwchar

Persyaratan

Rutin	Header yang diperlukan
putchar	<stdio.h>
putwchar	<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_putchar.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;

   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
      ch = putchar( *p );
}

Output

This is the line of output

Lihat juga

Streaming I/O
fputc, fputwc
getc, getwc