_sopen、_wsopen_sopen, _wsopen

• 4/2/2020
• • T
  • o
  • O
  • S
  • v

共有用にファイルを開きます。Opens a file for sharing. これらの関数のセキュリティを強化したバージョンについては 、「_sopen_s、_wsopen_s」を参照してください。More secure versions of these functions are available: see _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 ]
);

パラメーターParameters

filenamefilename
ファイル名。File name.

oflagoflag
許可される操作の種類。The kind of operations allowed.

shflagshflag
許可される共有の種類。The kind of sharing allowed.

pmodepmode
アクセス許可の設定。Permission setting.

戻り値Return Value

これらの各関数は、開かれたファイルのファイル記述子を返します。Each of these functions returns a file descriptor for the opened file.

Filename または oflag が NULL ポインターの場合、または oflag または shflag が有効な値の範囲内にない場合は、「パラメーターの検証」で説明されているように、無効なパラメーターハンドラーが呼び出されます。If filename or oflag is a NULL pointer, or if oflag or shflag is not within a valid range of values, the invalid parameter handler is invoked, as described in Parameter Validation. 実行の継続が許可された場合、これらの関数は-1 を返し、 errno を次のいずれかの値に設定します。If execution is allowed to continue, these functions return -1 and set errno to one of the following values.

リターン コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。For more information about these and other return codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

解説Remarks

_Sopen 関数は、 filename で指定されたファイルを開き、 oflag および shflag で定義されている共有の読み取りまたは書き込み用にファイルを準備します。The _sopen function opens the file specified by filename and prepares the file for shared reading or writing, as defined by oflag and shflag. _wsopen は _sopen のワイド文字バージョンです。_wsopen する filename 引数は、ワイド文字列です。_wsopen is a wide-character version of _sopen; the filename argument to _wsopen is a wide-character string. _wsopen と _sopen は同じように動作します。_wsopen and _sopen behave identically otherwise.

既定では、この関数のグローバル状態はアプリケーションにスコープが設定されています。By default, this function's global state is scoped to the application. これを変更するには、「 CRT でのグローバル状態」を参照してください。To change this, see Global state in the CRT.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

整数式 oflag は、で定義されている次のマニフェスト定数の1つ以上を組み合わせることによって形成され <fcntl.h> ます。The integer expression oflag is formed by combining one or more of the following manifest constants, which are defined in <fcntl.h>. 2つ以上の定数が引数 oflag を形成する場合、それらはビットごとの or 演算子 ( | ) と組み合わされます。When two or more constants form the argument oflag, they are combined with the bitwise-OR operator ( | ).

ファイルアクセスモードを指定するには、 _O_RDONLY、 _O_RDWR、 _O_WRONLY のいずれかを指定する必要があります。To specify the file access mode, you must specify either _O_RDONLY, _O_RDWR, or _O_WRONLY. アクセス モードに既定値はありません。There is no default value for the access mode.

_O_WTEXT、 _O_U8TEXT、または _O_U16TEXT を使用してファイルを Unicode モードで開くと、入力関数は、そのファイルから読み取られたデータを、型として格納された utf-16 データに変換し wchar_t ます。When a file is opened in Unicode mode by using _O_WTEXT, _O_U8TEXT, or _O_U16TEXT, input functions translate the data that's read from the file into UTF-16 data stored as type wchar_t. Unicode モードで開かれたファイルに書き込む関数は、型として格納された UTF-16 データを含むバッファーを想定 wchar_t します。Functions that write to a file opened in Unicode mode expect buffers that contain UTF-16 data stored as type wchar_t. ファイルが UTF-8 としてエンコードされている場合、UTF-16 データは書き込まれるときに UTF-8 に変換され、ファイルの UTF-8 でエンコードされた内容は読み取られるときに UTF-16 に変換されます。If the file is encoded as UTF-8, then UTF-16 data is translated into UTF-8 when it is written, and the file's UTF-8-encoded content is translated into UTF-16 when it is read. Unicode モードで奇数バイトの読み取りまたは書き込みを試みると、パラメーター検証エラーが発生します。An attempt to read or write an odd number of bytes in Unicode mode causes a parameter validation error. UTF-8 としてプログラムに格納されたデータを読み取るか書き込む場合は、Unicode モードではなくテキストまたはバイナリ ファイル モードを使用します。To read or write data that's stored in your program as UTF-8, use a text or binary file mode instead of a Unicode mode. 必要なエンコード変換は各自が行う必要があります。You are responsible for any required encoding translation.

_O_WRONLY | _O_APPEND (追加モード) と _O_WTEXT、 _O_U16TEXT、または _O_U8TEXT を使用して _sopen が呼び出された場合、まず読み取りと書き込みのためにファイルを開き、BOM を読み取り、書き込み専用で再度開くように試みます。If _sopen is called with _O_WRONLY | _O_APPEND (append mode) and _O_WTEXT, _O_U16TEXT, or _O_U8TEXT, it first tries to open the file for reading and writing, read the BOM, then reopen it for writing only. 読み取りおよび書き込み用にファイルを開くのに失敗した場合、書き込み専用でファイルを開き、Unicode モード設定の既定値を使用します。If opening the file for reading and writing fails, it opens the file for writing only and uses the default value for the Unicode mode setting.

引数 shflag は、で定義されている次のマニフェスト定数のいずれかで構成される定数式です <share.h> 。The argument shflag is a constant expression consisting of one of the following manifest constants, which are defined in <share.h>.

Pmode 引数は _O_CREAT が指定されている場合にのみ必要です。The pmode argument is required only when _O_CREAT is specified. ファイルが存在しない場合は、ファイルのアクセス許可の設定 を指定し ます。これは、新しいファイルが最初に閉じられたときに設定されます。If the file does not exist, pmode specifies the file's permission settings, which are set when the new file is closed the first time. それ以外の場合、 pmode は無視されます。Otherwise, pmode is ignored. pmode は、で定義されているマニフェスト定数 _S_IWRITE と _S_IREAD の一方または両方を含む整数式です <sys\stat.h> 。pmode is an integer expression that contains one or both of the manifest constants _S_IWRITE and _S_IREAD, which are defined in <sys\stat.h>. 両方の定数が指定されると、これらはビットごとの OR 演算子を使用して組み合わされます。When both constants are given, they are combined with the bitwise-OR operator. Pmode の意味は次のとおりです。The meaning of pmode is as follows.

書き込みアクセス許可が与えられない場合、ファイルは読み取り専用になります。If write permission is not given, the file is read-only. Windows オペレーティング システムでは、すべてのファイルは読み取り可能です。書き込み専用のアクセス許可を与えることはできません。In the Windows operating system, all files are readable; it is not possible to give write-only permission. そのため、モード _S_IWRITE と _S_IREAD | _S_IWRITE は同等です。Therefore, the modes _S_IWRITE and _S_IREAD | _S_IWRITE are equivalent.

_sopen は、アクセス許可が設定される前に、現在のファイルアクセス許可マスクを pmode に適用します。_sopen applies the current file-permission mask to pmode before the permissions are set. (「_umask」を参照。)(See _umask.)

必要条件Requirements

互換性について詳しくは、「 Compatibility」をご覧ください。For more compatibility information, see Compatibility.

例Example

「_locking」の例をご覧ください。See the example for _locking.

関連項目See also

低レベル i/oLow-Level I/O
_close_close
_creat、_wcreat_creat, _wcreat
fopen、_wfopenfopen, _wfopen
_fsopen、_wfsopen_fsopen, _wfsopen
_open、_wopen_open, _wopen