_fdopen, _wfdopen

Kojarzy strumień z plikiem, który został wcześniej otwarty dla operacji we/wy niskiego poziomu.

Składnia

FILE *_fdopen(
   int fd,
   const char *mode
);
FILE *_wfdopen(
   int fd,
   const wchar_t *mode
);

Parametry

fd
Deskryptor pliku otwartego.

mode
Typ dostępu do plików.

Wartość zwracana

Każda z tych funkcji zwraca wskaźnik do otwartego strumienia. Wartość wskaźnika o wartości null wskazuje błąd. W przypadku wystąpienia błędu wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie może być kontynuowane, errno jest ustawione na EBADFwartość , która wskazuje nieprawidłowy deskryptor plików lub EINVAL, co wskazuje, że mode był to wskaźnik o wartości null.

Aby uzyskać więcej informacji na temat tych i innych kodów błędów, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Funkcja _fdopen kojarzy strumień we/wy z plikiem, który jest identyfikowany przez fdelement , a tym samym umożliwia otwarcie pliku, który jest otwarty w celu buforowania i formatowania operacji we/wy niskiego poziomu. _wfdopen jest wersją szerokoznakową ; _fdopenargument to mode _wfdopen ciąg o szerokim znaku. _wfdopen i _fdopen w inny sposób zachowują się identycznie.

Deskryptory plików przekazywane do _fdopen są własnością zwróconego strumienia FILE * . Jeśli _fdopen operacja zakończy się pomyślnie, nie wywołaj _close deskryptora plików. Wywołanie fclose zwróconego skryptu FILE * zamyka również deskryptor plików.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby go zmienić, zobacz Stan globalny w CRT.

Ciąg mode znaków określa typ dostępu do pliku żądanego dla pliku:

Po otwarciu "a" pliku z typem dostępu lub "a+" wszystkie operacje zapisu są wykonywane na końcu pliku. Wskaźnik pliku można zmienić za pomocą polecenia fseek lub rewind, ale zawsze jest przenoszony z powrotem na koniec pliku przed przeprowadzeniem dowolnej operacji zapisu. W związku z tym istniejące dane nie mogą być zastępowane. Po określeniu "r+"typu , "w+"lub "a+" dostępu zarówno odczyt, jak i zapis są dozwolone (plik jest podobno otwarty dla "aktualizacji"). Jednak w przypadku przełączania się między odczytem i zapisem musi istnieć interweniowanie fflushoperacji , fsetpos, lub fseekrewind . Możesz określić bieżące położenie operacji fsetpos lub fseek , jeśli chcesz.

Oprócz powyższych wartości można również uwzględnić następujące znaki, mode aby określić tryb tłumaczenia dla znaków nowego wiersza:

Opcje t, ci n mode to rozszerzenia firmy Microsoft dla fopen systemów i _fdopen. Nie używaj ich, jeśli chcesz zachować przenośność ANSI.

Jeśli t wartość lub b nie jest podana w programie mode, domyślny tryb tłumaczenia jest definiowany przez zmienną globalną _fmode. Jeśli t argument lub b jest poprzedzony prefiksem, funkcja kończy się niepowodzeniem i zwraca wartość NULL. Aby zapoznać się z omówieniem trybów tekstowych i binarnych, zobacz Tekst i tryb binarny we/wy pliku.

Prawidłowe znaki dla ciągu używanego mode w fopen obiekcie i _fdopen odpowiadają oflag argumentom używanym w _open systemach i _sopen, jak pokazano w poniższej tabeli:

Wymagania

Aby uzyskać więcej informacji na temat zgodności standardów i konwencji nazewnictwa w bibliotece środowiska uruchomieniowego języka C, zobacz Zgodność.

Mapowania procedur tekstu ogólnego

Przykład

// crt_fdopen.c
// This program opens a file by using low-level
// I/O, then uses _fdopen to switch to stream
// access. It counts the lines in the file.

#include <stdlib.h>
#include <stdio.h>
#include <fcntl.h>
#include <io.h>
#include <share.h>

int main( void )
{
   FILE *stream;
   int  fd, count = 0;
   char inbuf[128];

   // Open a file.
   if( _sopen_s( &fd, "crt_fdopen.txt", _O_RDONLY, _SH_DENYNO, 0 ) )
      exit( 1 );

   // Get stream from file descriptor.
   if( (stream = _fdopen( fd, "r" )) == NULL )
      exit( 1 );

   while( fgets( inbuf, 128, stream ) != NULL )
      count++;

   // After _fdopen, close by using fclose, not _close.
   fclose( stream );
   printf( "Lines in file: %d\n", count );
}

Dane wejściowe: crt_fdopen.txt

Line one
Line two

Wynik

Lines in file: 2

Zobacz też

We/Wy strumienia
_dup, _dup2
fclose, _fcloseall
fopen, _wfopen
freopen, _wfreopen
_open, _wopen