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
Fungsi | 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 );
}
}
Masukan: crt_fgets.txt
Line one.
Line two.
Output
Line one.