fgetc, fgetwc

Makale
02/26/2013

Bir karakteri bir akışından okuma.

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

Parametreler

stream
İşaretçi FILE yapısı.

Dönüş Değeri

fgetcolarak okuma karakteri verir bir int veya verir EOF bir hata veya dosya sonu belirtmek için.fgetwcverir, olarak bir wint_t, okuma karaktere karşılık gelen ya da döndürür geniş karakteri WEOF bir hata veya dosya sonu belirtmek için.Her iki işlevlerini kullanmak feof veya ferror bir hata ve dosya sonu koşul arasında ayrım yapmak için.Okuma hatası oluşursa, hata göstergesi akışı için ayarlanır.stream Olan NULL, fgetc ve fgetwc açıklandığı gibi geçersiz bir parametre işleyicisi çağırmak Parametre doğrulama.Yürütülmesine devam etmek için izin verilmişse, bu işlevler kümesi errno için EINVAL ve EOF.

Notlar

Bu işlevlerden her biri tek bir karakteri ile ilişkili dosya geçerli konumdan okur stream.İşlev sonra ilişkili dosya işaretçisi (tanımlanmışsa) sonraki karaktere işaret edecek şekilde artırır.Akış dosya sonu ise, dosya sonu göstergesi akışı için ayarlanır.

fgetceşittir getc, ancak yalnızca bir işlev yerine bir işlev ve makro olarak uygulanır.

fgetwcgeniş karakter sürümü fgetc; bunu okuyan c olarak çok baytlı bir karakter veya bir geniş karaktere göre mi stream metin modunda veya ikili modunda açılır.

Sürümleriyle _nolock sonek dışında başka bir iş parçacığı tarafından girişime korunmaz, özdeş.

Geniş ve çok baytlı karakterler metin ve ikili modları işleme hakkında daha fazla bilgi için bkz: 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
_fgettc	fgetc	fgetc	fgetwc

Gereksinimler

İşlev	Gerekli başlık
fgetc	<stdio.h>
fgetwc	<stdio.h> veya <wchar.h>

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

Örnek

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

Giriş: crt_fgetc.txt

Line one.
Line two.

Çıktı

Line one.
Line two.

.NET Framework Eşdeğeri

Ayrıca bkz.

Başvuru

G/ç

fputc, fputwc

getc, getwc

Aracılığıyla paylaş