fgets, fgetws

Artikel
02/26/2013

Rufen Sie eine Zeichenfolge aus einem Stream ab.

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

Parameter

str
Speicherort für Daten.
n
Maximale Anzahl der zu lesenden Zeichen.
stream
Zeiger auf FILE Struktur.

Rückgabewert

Jede dieser Funktionen vorhanden sind strzurück.NULL wird zurückgegeben, um einen Fehler oder eine Dateiende-Bedingung anzugeben.Verwenden Sie feof oder ferror , um zu bestimmen, ob ein Fehler aufgetreten ist.Wenn str oder stream ein NULL-Zeiger ist, oder n kleiner oder gleich null ist, Aufrufe dieser Funktion der ungültige Parameter für, wie in Parametervalidierungbeschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EINVAL festgelegt, und die Funktion gibt NULLzurück.

Weitere Informationen finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr Weitere Informationen über diese und andere Fehlercodes.

Hinweise

Die fgets-Funktion liest eine Zeichenfolge aus der Eingabe stream-Argument und speichert sie in str.fgets liest Zeichen aus der aktuellen Position im Stream und das erste Zeilenumbruchzeichen am Ende des Streams erreicht ist oder bis die Anzahl der gelesenen Zeichen einzubeziehen ist gleich n 1, das zuerst stammt.Das Ergebnis, das in str gespeichert wird, wird mit einem NULL-Zeichen angefügt.Das Zeilenumbruchzeichen, wenn sie gelesen wird, wird in der Zeichenfolge enthalten.

fgetws ist eine Breitzeichen-Version von fgets.

fgetws Breitzeiche str liest das Argument als Zeichenfolge mit Breitzeichen oder Mehrbyte-Zeichenfolge, je nachdem ob stream im Textmodus oder im binären Modus geöffnet ist.Weitere Informationen über die Verwendung von Text- und Binärdatei ändert in Unicode und Mehrbytem stream-I/O finden Sie unter Text und Binärdatei-Modus-Datei E/A und Unicode-Datenstrom E/A in den Text-und Binärdatei-Modi.

Zuweisung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definieren	_UNICODE definiert
_fgetts	fgets	fgets	fgetws

Anforderungen

Funktion	Erforderlicher Header
fgets	<stdio.h>
fgetws	<stdio.h> oder <wchar.h>

Um Kompatibilität zusätzlichen Informationen finden Sie unter Kompatibilität in der Einführung.

Beispiel

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