fgetc, fgetwc

Lisez un caractère d'un flux de données.

int fgetc( 
   FILE *stream 
);
wint_t fgetwc( 
   FILE *stream 
);

Paramètres

• stream
  Pointeur vers la structure d' FILE .

Valeur de retour

fgetc retourne le caractère lu comme int ou retourne EOF pour indiquer une erreur ou de fin de fichier.fgetwc retourne, comme wint_t, le caractère élargi correspondant au caractère lit ou retourne WEOF pour indiquer une erreur ou de fin de fichier.Pour les deux fonctions, utilisez feof ou ferror pour distinguer une erreur et une condition fin de fichier.Si une erreur de lecture se produit, l'indicateur d'erreur pour le flux est défini.si stream est NULL, fgetc et fgetwc appellent le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, ces errno défini par fonctions à EINVAL et à EOFde retour.

Notes

Chacune de ces fonctions indique qu'un caractère unique de la position actuelle du fichier associé à stream.La fonction incrémente le pointeur de fichier associé (s'il est défini) pour indiquer le caractère suivant.Si le flux est à la fin de le fichier, l'indicateur de fin de fichier pour le flux est défini.

fgetc équivaut à getc, mais est implémentée uniquement comme fonction, plutôt que comme fonction et macro.

fgetwc est la version à caractère élargi d' fgetc; il lit c comme un caractère multioctets ou caractère élargi selon qu' stream est ouvert en mode texte ou le mode binaire.

Les versions par le suffixe d' _nolock sont identiques mais elles ne sont pas protégés interférence avec à d'autres threads.

Pour plus d'informations sur le traitement des caractères larges et les caractères multioctets en modes de texte et de binaire, consultez 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

Configuration requise

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

Exemple

// crt_fgetc.c
// This program uses getc to read the first
// 80 input characters (or until the end of input)
// and place them into a string named buffer.
 

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   FILE *stream;
   char buffer[81];
   int  i, ch;

   // Open file to read line from:
   fopen_s( &stream, "crt_fgetc.txt", "r" );
   if( stream == NULL )
      exit( 0 );

   // Read in first 80 characters and place them in "buffer": 
   ch = fgetc( stream );
   for( i=0; (i < 80 ) && ( feof( stream ) == 0 ); i++ )
   {
      buffer[i] = (char)ch;
      ch = fgetc( stream );
   }

   // Add null to end string 
   buffer[i] = '\0';
   printf( "%s\n", buffer );
   fclose( stream );
}

entrée : crt_fgetc.txt

Line one.
Line two.

Sortie

Line one.
Line two.

Équivalent .NET Framework

• System : : E/S : : StreamReader : : lecture

• System : : console : : lecture

Voir aussi

Référence

E/S de flux

fputc, fputwc

getc, getwc