ACCESS

可搬用関数：ファイルが存在するかどうかとそれがどのように参照できるかを決定します。

モジュール：USE DFPORT

形式

result = ACCESS (name, mode)

name
(入力) CHARACTER*(*)。参照許可モードを調べるファイル名。

mode
(入力) CHARACTER*(*)。調べたい参照許可モード。文字 "r"，"w"，"x"，または "" (空白) のみを含む 1 文字以上の大きさをもつ文字列でなければなりません。これらの文字は，以下のように解釈されます。

文字	意味
r	読み取り許可に対する検証を行います。
w	書き込み許可に対する検証を行います。
x	実行許可 (名前は .COM，.EXE，.BAT，または .CMD でなければなりません) に対する検証を行います。
(空白)	存在するかどうかを検証します。

mode 中の文字は，任意の順番，組み合わせにすることができます。たとえば，wrx と r は mode の有効な書式で，問い合わせの同じ組を表します。

結果

結果の型は INTEGER(4) です。mode で指定したすべての問い合わせが肯定的であれば，ゼロが返されます。引数が不正であるか，指定したモードのすべてでファイルが参照できない場合，以下のエラーの 1 つが返されます。

• EACCES - 参照が拒否されました。ファイルの許可設定が指定した参照許可モードを許していません。

• EINVAL - mode 引数が不正です。

• ENOENT - ファイルまたはパスが見つかりませんでした。

エラー・コードの一覧は，「IERRNO」を参照してください。

name 引数は，パス区切り子としてスラッシュ (/) とバックスラッシュ (\) を含むことができます。

すべてのファイルが読み取り可能であることに注意してください。読み取り許可の検証は，常に 0 が返されます。

互換性

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

関連情報

GETFILEINFOQQ, INQUIRE

例

	! ファイル "DATAFILE.TXT" の読み取り許可と書き込み許可を検証します。
	J = ACCESS ("DATAFILE.TXT", "rw")
	! "DATAFILE.TXT" が実行可能かどうかを検証します。
	! ファイル名が .COM, .EXE, .BAT, または .CMD で終わっていないので，実行可能ではありません。
	J = ACCESS ("DATAFILE.TXT","x")