fgets, fgetws
Bir dize, bir akışından alın.
char *fgets(
char *str,
int n,
FILE *stream
);
wchar_t *fgetws(
wchar_t *str,
int n,
FILE *stream
);
Parametreler
str
Veri için depolama konumu.n
Okumak için karakter sayısı üst sınırı.stream
İşaretçi FILE yapısı.
Dönüş Değeri
Bunların her biri verir işlevleri str.NULLbir hata veya bir dosya sonu koşul belirtmek için döndürülür.Use feof veya ferror bir hata olup olmadığını belirlemek için.str Veya stream bir null işaretçi veya n az veya eşit açıklandığı gibi bu işlev sıfır olarak geçersiz parametre işleyiciyi çağırır Parametre Doğrulama.Yürütülmesine devam etmek için izin verilip verilmediğini errno ayarlamak EINVAL işlevini verir ve NULL.
Bkz: _doserrno, errno, _sys_errlist ve _sys_nerr bu ve diğer hata kodları hakkında daha fazla bilgi için.
Notlar
fgets İşlevi bir dize girdileri okur stream bağımsız değişkeni içinde saklar ve str.fgetsGeçerli akış konumu karakter okur ve akış veya okunan karakterlerin sayısı kadar sonuna ilk yeni satır karakteri de dahil olmak üzere eşit n – 1, hangisi önce gelirse.Sonuç depolanan str boş karakter eklenir.Yeni satır karakteri, okuma, dizeye dahil.
fgetwsgeniş karakter sürümü fgets.
fgetwsgeniş karakter değişkeni okur str çok baytlı karakter dizesi ya da bir geniş karakter dizesine göre mi stream sırasıyla metin modunda veya ikili modunda açılmış.Metin ve ikili modda Unicode ve çok baytlı akış-ı/o kullanma hakkında daha fazla bilgi için bkz: metin ve ikili mod dosya g/Ç ve Metin ve ikili modları Unicode akımı g/Ç.
Genel metin yordamı eşlemeleri
TCHAR.H yordamına girildi |
_UNICODE & _mbcs tanımlı değil |
Tanımlanan _mbcs |
Tanımlanan _UNICODE |
---|---|---|---|
_fgetts |
fgets |
fgets |
fgetws |
Gereksinimler
İşlev |
Gerekli başlık |
---|---|
fgets |
<stdio.h> |
fgetws |
<stdio.h> veya <wchar.h> |
Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.
Örnek
// crt_fgets.c
// This program uses fgets to display
// a line from a file on the screen.
//
#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\n" );
else
printf( "%s", line);
fclose( stream );
}
}
Giriş: crt_fgets.txt
Line one.
Line two.
Çıktı
Line one.