_fsopen, _wfsopen

Otwiera strumień z udostępnianiem plików.

Składnia

FILE *_fsopen(
   const char *filename,
   const char *mode,
   int shflag
);
FILE *_wfsopen(
   const wchar_t *filename,
   const wchar_t *mode,
   int shflag
);

Parametry

filename
Nazwa pliku do otwarcia.

mode
Typ dozwolonego dostępu.

shflag
Dozwolony typ udostępniania.

Wartość zwracana

Każda z tych funkcji zwraca wskaźnik do strumienia. Wartość wskaźnika o wartości null wskazuje błąd. Jeśli filename ciąg lub mode jest NULL pusty, te funkcje wywołują nieprawidłową procedurę obsługi parametrów zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonanie jest dozwolone do kontynuowania, te funkcje zwracają NULL i ustawiają wartość errnoEINVAL.

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

Uwagi

Funkcja _fsopen otwiera plik określony filename przez jako strumień i przygotowuje plik do późniejszego wspólnego odczytu lub zapisu, zgodnie z definicją w trybie i shflag argumentach. _wfsopenjest wersją wieloznakową ; _fsopenfilename argumenty i mode to _wfsopen ciągi szerokoznakowe. _wfsopen i _fsopen zachowywać się identycznie inaczej.

Ciąg mode znaków określa typ dostępu żądanego dla pliku, jak pokazano w poniższej tabeli.

w z rozwagą, ponieważ mogą zniszczyć istniejące pliki.

Po otwarciu pliku z typem dostępu "a" lub "a+" wszystkie operacje zapisu są wykonywane na końcu pliku. Wskaźnik pliku można zmienić przy użyciu polecenia fseek lub rewind, ale zawsze jest przenoszony z powrotem na koniec pliku, zanim zostanie przeprowadzona jakakolwiek operacja zapisu. W związku z tym istniejące dane nie mogą być zastępowane. Po określeniu typu dostępu "r+", "w+" lub "a+" , zarówno odczyt, jak i zapis są dozwolone (plik ma być otwarty do aktualizacji). Jednak podczas przełączania między odczytem i zapisem musi istnieć interweniowanie fsetposoperacji , fseeklub rewind . Bieżące położenie można określić dla fsetpos operacji lub fseek , jeśli jest to konieczne. Oprócz powyższych wartości można dołączyć jeden z następujących znaków w mode celu określenia trybu tłumaczenia dla nowych wierszy i zarządzania plikami.

Jeśli t w b trybie tłumaczenia nie podano modewartości , tryb tłumaczenia jest definiowany przez zmienną trybu _fmodedomyślnego . 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.

Dotyczy T i D:

• T program unika zapisywania pliku na dysku, o ile nie wymaga tego wykorzystanie pamięci. Aby uzyskać więcej informacji, zobacz FILE_ATTRIBUTE_TEMPORARY w temacie Stałe atrybutów pliku, a także ten wpis w blogu Jest to tylko tymczasowe.
• D określa zwykły plik zapisywany na dysku. Różnica polega na tym, że jest on automatycznie usuwany po zamknięciu. Można połączyć TD w celu uzyskania obu semantyki.

_fsopeni _wfsopen są wariantami specyficznymi dla firmy Microsoft.fopen Nie są one częścią standardu ANSI. W przypadku bardziej przenośnej i bezpiecznej funkcji, jeśli nie potrzebujesz udostępniania plików, rozważ użycie funkcji _wfopen_s lub fopen_s.

Argument shflag jest wyrażeniem stałym składającym się z jednej z następujących stałych manifestu zdefiniowanych w pliku Share.h.

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

Mapowania procedur tekstu ogólnego

Wymagania

Przykład

// crt_fsopen.c

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

int main( void )
{
   FILE *stream;

   // Open output file for writing. Using _fsopen allows us to
   // ensure that no one else writes to the file while we are
   // writing to it.
    //
   if( (stream = _fsopen( "outfile", "wt", _SH_DENYWR )) != NULL )
   {
      fprintf( stream, "No one else in the network can write "
                       "to this file until we are done.\n" );
      fclose( stream );
   }
   // Now others can write to the file while we read it.
   system( "type outfile" );
}

No one else in the network can write to this file until we are done.

Zobacz też

We/Wy strumienia
fclose, _fcloseall
_fdopen, _wfdopen
ferror
_fileno
fopen, _wfopen
freopen, _wfreopen
_open, _wopen
_setmode
_sopen, _wsopen