fgets, fgetws

Article
03/26/2013

obtenez une chaîne d'un flux de données.

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

Paramètres

str
Emplacement de stockage des données.
n
Nombre maximal de caractères à lire.
stream
Pointeur vers la structure d' FILE .

Valeur de retour

Chacune de ces fonctions retourne str.NULL est retourné pour indiquer une erreur ou une condition fin de fichier.Utilisez feof ou ferror pour déterminer si une erreur s'est produite.si str ou stream est un pointeur null, ou n est inférieur ou égal à zéro, cette fonction appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, errno est défini à EINVAL et la fonction retourne NULL.

Consultez _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur ce point, ainsi que d'autres, les codes d'erreur.

Notes

la fonction d' fgets lit une chaîne de l'argument d'entrée d' stream et l'enregistre dans str.les caractères à partir defgets de la position actuelle de flux et d'inclure le premier caractère de saut de ligne, à la fin de le flux de données, ou jusqu'à ce que le nombre de lecture de caractères est égal à n - 1, celui qui vient en premier.Le résultat enregistré dans str reçoit un caractère Null.Le caractère de saut de ligne, si lu, est inclus dans la chaîne.

fgetws est une version à caractère élargi d' fgets.

fgetws lit l'argument à caractère élargi str comme une chaîne de caractères multioctets ou chaîne à caractères larges selon qu' stream est ouvert en mode texte ou le mode de fichier binaire, respectivement.Pour plus d'informations sur l'utilisation des modes de texte et de binaire en Unicode et stream-I/O multioctets, consultez E/S de fichier du mode de texte et de binaire et l' E/S de flux de données Unicode dans des modes de texte et de binaire.

mappages de routines de texte générique

routine de TCHAR.H	_MBCS & de _UNICODE non défini	_MBCS défini	_UNICODE défini
_fgetts	fgets	fgets	fgetws

Configuration requise

Fonction	en-tête requis
fgets	<stdio.h>
fgetws	<stdio.h> ou <wchar.h>

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

Exemple

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