_sopen、_wsopen

共有用にファイルを開きます。 これらの関数のより安全なバージョンを使用できます。 _sopen_s、 _wsopen_sを参照してください。

構文

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

パラメーター

filename
ファイル名。

oflag
許可される操作の種類。

shflag
許可される共有の種類。

pmode
アクセス許可の設定。

戻り値

これらの各関数は、開かれたファイルのファイル記述子を返します。

filenameまたはoflagがNULL ポインターである場合、またはoflagまたはshflagが有効な値の範囲内にない場合は、「パラメーター検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、これらの関数は -1 を返し、errno を次のいずれかの値に設定します。

これらのリターン コードとその他のリターン コードについては、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。

解説

_sopen 関数は、filename で指定されたファイルを開き、oflag および shflag による定義に従って、共有読み取りまたは書き込み用にファイルを準備します。 _wsopen 関数は、 _sopen関数のワイド文字バージョンです。 filename 関数の引数 _wsopen は、ワイド文字列です。 それ以外では、_wsopen と _sopen の動作は同じです。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 これを変更するには、「CRT でのグローバル状態」を参照してください。

汎用テキスト ルーチンのマップ

整数式 oflag は、 <fcntl.h>で定義されている次のマニフェスト定数の 1 つ以上を組み合わせることによって形成されます。 引数 oflagを形成する定数が複数ある場合、ビットごとの OR 演算子 ( | ) と組み合わされます。

ファイル アクセス モードを指定するには、_O_RDONLY、_O_RDWR、または _O_WRONLY を指定する必要があります。 アクセス モードの既定値はありません。

_O_WTEXT、_O_U8TEXT、または _O_U16TEXT を使用してファイルが Unicode モードで開かれると、Input 関数によって、ファイルから読み取られたデータは wchar_t 型として格納された UTF-16 データに変換されます。 Unicode モードで開かれたファイルに書き込む関数は、 wchar_t型として格納された UTF-16 データがバッファーに含まれていると想定します。 ファイルが UTF-8 としてエンコードされている場合、UTF-16 データは書き込み時に UTF-8 に変換されます。 ファイルの UTF-8 でエンコードされたコンテンツは、読み取り時に UTF-16 に変換されます。 Unicode モードで奇数バイトの読み取りまたは書き込みを試みると、 パラメーター検証 エラーが発生します。 UTF-8 としてプログラムに格納されたデータを読み取るか書き込む場合は、Unicode モードではなくテキストまたはバイナリ ファイル モードを使用します。 必要なエンコード翻訳は、お客様の責任で行います。

_sopen では、_O_WRONLY | _O_APPEND (追加モード) および _O_WTEXT、_O_U16TEXT、または _O_U8TEXT を使用して呼び出された場合、最初に読み取りおよび書き込み用にファイルを開き、BOM を読み取り、次に書き込み専用で再度開こうとします。 読み取りおよび書き込み用にファイルを開くのに失敗した場合、書き込み専用でファイルを開き、Unicode モード設定の既定値を使用します。

引数 shflag は、 <share.h>で定義されている次のいずれかのマニフェスト定数で構成される定数式です。

pmode が指定された場合にのみ _O_CREAT 引数が必要です。 ファイルが存在しない場合、 pmode は、新しいファイルを初めて閉じるときに設定されるファイルのアクセス許可設定を指定します。 それ以外の場合は、pmode は無視されます。 pmode は、_S_IWRITE で定義されているマニフェスト定数 _S_IREAD と <sys\stat.h> のいずれか、または両方が含まれた整数式です。 両方の定数を指定すると、ビットごとの OR 演算子と組み合わされます。 pmode の意味は次のとおりです。

書き込みアクセス許可が与えられていない場合、ファイルは読み取り専用です。 Windows オペレーティング システムでは、すべてのファイルが読み取り可能です。書き込み専用のアクセス許可を付与することはできません。 したがって、_S_IWRITE モードと _S_IREAD | _S_IWRITE モードは等価です。

_sopen では、アクセス許可が設定される前に、現在のファイル アクセス許可マスクが pmode に適用されます。 詳細については、_umaskを参照してください。

要件

互換性の詳細については、「 Compatibility」を参照してください。

例

_locking の例を参照してください。

関連項目

低レベル I/O
_close
_creat, _wcreat
fopen, _wfopen
_fsopen, _wfsopen
_open, _wopen