IS_OPEN

IS_OPEN 関数は、ファイルハンドルが開いているファイルを表しているかどうかをテストするために使用されます。

構文

UTL_FILE.IS_OPEN (
   file  IN FILE_TYPE)
  RETURN BOOLEAN;

パラメータ説明

戻り値

IS_OPENの戻り値の型はBOOLEANです。

• TRUEを返す：指定されたファイルハンドルが有効であり、対応するファイルが開いている状態にあることを示します。
• FALSEを返す：ファイルが閉じられているか、指定されたハンドルが無効であることを示します。

例外

• INVALID_FILEHANDLE

使用上の注意

• IS_OPENに渡されるハンドルは、成功したFOPENまたはFOPEN_NCHAR呼び出しから取得したものでなければなりません。初期化されていない、または解放されたハンドルを渡すと、関数はFALSEを返します。
• IS_OPENは、ファイルハンドルが開いているがまだ閉じられていないファイルを表しているかどうかのみを報告し、そのファイルハンドルの使用中にオペレーティングシステムエラーが発生しないことを保証するものではありません。
• UTL_FILEパッケージのほとんどのプロシージャとは異なり、IS_OPENは通常例外をスローしません。その設計目的は安全に状態を照会することであるため、ハンドルが無効であっても、エラーを報告する代わりにFALSEを返します。