fputc, fputwc

Menulis karakter ke aliran.

Sintaks

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

Parameter

c
Karakter yang akan ditulis.

stream
Penunjuk ke FILE struktur.

Nilai hasil

Masing-masing fungsi ini mengembalikan karakter yang ditulis. Untuk fputc, nilai EOF pengembalian menunjukkan kesalahan. Untuk fputwc, nilai WEOF pengembalian menunjukkan kesalahan. Jika stream adalah NULL, fungsi ini memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, eksekusi akan kembali EOF dan diatur errno ke EINVAL.

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

Keterangan

Masing-masing fungsi ini menulis karakter c tunggal ke file pada posisi yang ditunjukkan oleh indikator posisi file terkait, jika ditentukan. Fungsi memajukan indikator sebagaimana mewajarkan. Di fputc dan fputwc, file dikaitkan dengan stream. Jika file tidak dapat mendukung permintaan penempatan atau dibuka dalam mode penambalan, karakter ditambahkan ke akhir aliran.

Dua fungsi tersebut bersifat identik jika aliran dibuka dalam mode ANSI. fputc 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_fputc_nolock, _fputwc_nolock.

Sambutan khusus rutin mengikuti.

Rutin	Keterangan
fputc	Setara dengan putc, tetapi hanya diimplementasikan sebagai fungsi, bukan sebagai fungsi dan makro.
fputwc	Versi karakter luas dari fputc. c Menulis sebagai karakter multibyte atau karakter lebar saat stream dibuka dalam mode teks atau mode biner.

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
_fputtc	fputc	fputc	fputwc

Persyaratan

Function	Header yang diperlukan
fputc	<stdio.h>
fputwc	<stdio.h> atau <wchar.h>

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

Contoh

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

}

This is a test of fputc!!

Baca juga

Streaming I/O
fgetc, fgetwc
putc, putwc