fgets, fgetws

Dapatkan string dari aliran.

Sintaks

char *fgets(
   char *str,
   int numChars,
   FILE *stream
);
wchar_t *fgetws(
   wchar_t *str,
   int numChars,
   FILE *stream
);

Parameter

str
Lokasi penyimpanan untuk data.

numChars
Jumlah maksimum karakter yang akan dibaca.

stream
Penunjuk ke FILE struktur.

Nilai hasil

Masing-masing fungsi ini mengembalikan str. NULL dikembalikan untuk menunjukkan kesalahan atau kondisi akhir file. Gunakan feof atau ferror untuk menentukan apakah terjadi kesalahan. Jika str atau stream adalah penunjuk null, atau numChars kurang dari atau sama dengan nol, fungsi ini memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, errno diatur ke EINVAL dan fungsi mengembalikan NULL.

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

Keterangan

Fungsi fgets membaca string dari argumen input stream dan menyimpannya di str. fgets membaca karakter dari posisi aliran saat ini ke dan menyertakan karakter baris baru pertama, ke akhir aliran, atau sampai jumlah karakter yang dibaca sama dengan numChars - 1, mana yang lebih dulu. Hasil yang disimpan di str ditambahkan dengan karakter null. Karakter baris baru, jika dibaca, disertakan dalam string.

fgetws adalah versi karakter luas dari fgets.

fgetws membaca argumen str karakter lebar sebagai string karakter multibyte atau sebagai string karakter lebar saat stream dibuka dalam mode teks atau mode biner. Untuk informasi selengkapnya tentang menggunakan mode teks dan biner di Unicode dan multibyte stream-I/O, lihat Teks dan mode biner file I/O dan Unicode stream I/O dalam mode teks dan biner.

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

Pemetaan rutin teks generik

TCHAR.H Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_fgetts	fgets	fgets	fgetws

Persyaratan

Function	Header yang diperlukan
fgets	<stdio.h>
fgetws	<stdio.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

// crt_fgets.c
// This program uses fgets to display
// the first line from a file.

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char line[100];

   if( fopen_s( &stream, "crt_fgets.txt", "r" ) == 0 )
   {
      if( fgets( line, 100, stream ) == NULL)
         printf( "fgets error\numChars" );
      else
         printf( "%s", line);
      fclose( stream );
   }
}

Input: crt_fgets.txt

Line one.
Line two.

Hasil

Line one.

Baca juga

Streaming I/O
fputs, fputws
gets, _getws
puts, _putws