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を返します。