fputs, fputws

Menulis string ke aliran.

Sintaks

int fputs(
   const char *str,
   FILE *stream
);
int fputws(
   const wchar_t *str,
   FILE *stream
);

Parameter

str
String output.

stream
Penunjuk ke FILE struktur.

Nilai hasil

Masing-masing fungsi ini mengembalikan nilai nonnegatif jika berhasil. Pada kesalahan, fputs dan fputws kembalikan EOF. Jika str atau stream adalah penunjuk null, fungsi-fungsi ini memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi-fungsi ini diatur errno ke EINVAL lalu mengembalikan EOF.

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

Keterangan

Masing-masing fungsi ini menyalin str ke output stream pada posisi saat ini. fputws menyalin argumen str karakter lebar ke stream sebagai string karakter multibyte atau string karakter lebar saat stream dibuka dalam mode teks atau mode biner. Tidak ada fungsi yang menyalin karakter null yang mengakhiri.

Dua fungsi tersebut bersifat identik jika aliran dibuka dalam mode ANSI. fputs saat ini tidak mendukung output ke dalam aliran UNICODE.

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

Pemetaan rutin teks generik

TCHAR. Rutinitas H	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_fputts	fputs	fputs	fputws

Persyaratan

Fungsi	Header yang diperlukan
fputs	<stdio.h>
fputws	<stdio.h> atau <wchar.h>

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

Contoh

// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.

#include <stdio.h>

int main( void )
{
   fputs( "Hello world from fputs.\n", stdout );
}

Hello world from fputs.

Lihat juga

Streaming I/O
fgets, fgetws
gets, _getws
puts, _putws