_sopen, _wsopen

Öppnar en fil för delning. Säkrare versioner av dessa funktioner är tillgängliga: se _sopen_s, _wsopen_s.

Syntax

int _sopen(
   const char *filename,
   int oflag,
   int shflag [,
   int pmode ]
);
int _wsopen(
   const wchar_t *filename,
   int oflag,
   int shflag [,
   int pmode ]
);

Parameterar

filename
Filnamn.

oflag
Den typ av åtgärder som tillåts.

shflag
Den typ av delning som tillåts.

pmode
Behörighetsinställning.

Returvärde

Var och en av dessa funktioner returnerar en filbeskrivning för den öppnade filen.

Om filename eller oflag är en NULL pekare, eller om oflag eller shflag inte ligger inom ett giltigt värdeintervall, anropas den ogiltiga parameterhanteraren enligt beskrivningen i Parameterverifiering. Om körningen tillåts fortsätta returnerar dessa funktioner -1 och anges errno till något av följande värden.

Mer information om dessa och andra returkoder finns i errno, _doserrno, _sys_errlistoch _sys_nerr.

Anmärkningar

Funktionen _sopen öppnar filen som anges av filename och förbereder filen för delad läsning eller skrivning, enligt definitionen av oflag och shflag. _wsopen är en bred teckenversion av _sopen; filename argumentet till _wsopen är en sträng med många tecken. _wsopen och _sopen beter sig identiskt annars.

Som standard är den här funktionens globala tillstånd begränsat till programmet. Information om hur du ändrar det finns i Globalt tillstånd i CRT-.

Allmän textrutinmappning

Heltalsuttrycket oflag skapas genom att en eller flera av följande manifestkonstanter kombineras, som definieras i <fcntl.h>. När två eller flera konstanter utgör argumentet oflagkombineras de med bitwise-OR-operatorn ( | ).

Om du vill ange filåtkomstläget måste du ange antingen _O_RDONLY, _O_RDWReller _O_WRONLY. Det finns inget standardvärde för åtkomstläget.

När en fil öppnas i Unicode-läge med hjälp _O_WTEXTav indatafunktionerna , _O_U8TEXTeller _O_U16TEXTöversätter indata som läses från filen till UTF-16-data som lagras som typ wchar_t. Funktioner som skriver till en fil som öppnas i Unicode-läge förväntar sig buffertar som innehåller UTF-16-data som lagras som typ wchar_t. Om filen kodas som UTF-8 översätts UTF-16-data till UTF-8 när den skrivs. Filens UTF-8-kodade innehåll översätts till UTF-16 när den läses. Ett försök att läsa eller skriva ett udda antal byte i Unicode-läge orsakar ett parameterverifieringsfel. Om du vill läsa eller skriva data som lagras i programmet som UTF-8 använder du ett text- eller binärfilläge i stället för ett Unicode-läge. Du ansvarar för all nödvändig kodningsöversättning.

Om _sopen anropas med _O_WRONLY | _O_APPEND (tilläggsläge) och _O_WTEXT, _O_U16TEXTeller _O_U8TEXT, försöker den först öppna filen för att läsa och skriva, läsa bommen och sedan öppna den för endast skrivning. Om det inte går att öppna filen för läsning och skrivning öppnas filen endast för skrivning och använder standardvärdet för unicode-lägesinställningen.

Argumentet shflag är ett konstant uttryck som består av en av följande manifestkonstanter, som definieras i <share.h>.

Argumentet pmode krävs endast när _O_CREAT anges. Om filen inte finns pmode anger du filens behörighetsinställningar, som anges när den nya filen stängs första gången. Annars pmode ignoreras. pmode är ett heltalsuttryck som innehåller en eller båda manifestkonstanterna _S_IWRITE och _S_IREAD, som definieras i <sys\stat.h>. När båda konstanterna anges kombineras de med bitwise-OR-operatorn. Innebörden av pmode är följande.

Om skrivbehörighet inte ges är filen skrivskyddad. I Windows-operativsystemet är alla filer läsbara. det går inte att ge skrivskyddad behörighet. Därför är lägena _S_IWRITE och _S_IREAD | _S_IWRITE likvärdiga.

_sopen tillämpar den aktuella filbehörighetsmasken pmode på innan behörigheterna anges. Mer information finns i _umask.

Kravspecifikation

Mer kompatibilitetsinformation finns i Kompatibilitet.

Exempel

Se exemplet för _locking.

Se även

Lågnivå-I/O
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen