IS_OPEN は、ハンドルがまだ開いているかどうかを判断するための句です。異常発生時に FCLOSE を実行するかどうかを決定する際によく使用されます。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity Editionは現在サポートされていません。
構文
UTL_FILE.IS_OPEN(file)
パラメータ説明
パラメータ |
説明 |
|---|---|
| file | FOPEN の呼び出しによって返されたアクティブなファイルハンドル。 |
戻り値
IS_OPEN の戻り値の型は BOOLEAN です。 TRUE を返す:指定されたファイルハンドルが有効であり、対応するファイルが開いていることを示します。 FALSE を返す:ファイルが閉じられているか、指定されたハンドルが無効であることを示します。
使用方法
IS_OPENに渡されるハンドルは、成功したFOPENまたはFOPEN_NCHAR呼び出しから取得したものでなければなりません。初期化されていない、または解放されたハンドルを渡すと、関数はFALSEを返します。UTL_FILEパッケージのほとんどのプロシージャとは異なり、IS_OPENは通常例外をスローしません。その設計目的は安全に状態を確認することであるため、ハンドルが無効であってもエラーを報告する代わりにFALSEを返します。