5.5 アクセスするためにNetCDFファイルをオープンする: NF_OPEN

---

関数NF_OPENは既存のNetCDFファイルとアクセスするためにオープンします。

用法
INTEGER FUNCTION NF_OPEN(CHARACTER*(*) PATH, INTEGER OMODE, INTEGER ncid)

PATH	オープンするNetCDFファイルのファイル名
OMODE	零値は (または NF_NOWRITE)はデフォルトステータス(ファイルは読取専用にオープンし、効率のためにバッファリング及びキャッシュする)を指定します。 それ以外の場合には、生成モードは NF_WRITE、NF_SHARE、または IOR(NF_WRITE, NF_SHARE)です。NF_WRITE フラグを設定することによりファイルを読取-書き込み両用にオープンします。(”書き込み”とはファイルに加え得るすべての変更を指し、データの付加または変更、次元・変数・属性の付加または名前の変更、属性の削除等の操作を含みます。) NF_SHAREフラグはファイルに書き込む処理とファイルを読み取る処理が一つもしくは複数行なわれている場合に適切です。これによって、ファイルへのアクセスはバッファーされず、キャッシュも制限されます。バッファー機構は連続アクセスに対して最適化されているので、データを連続的にアクセスしないプログラムにおいてはNF_SHARE フラグを設定することによりパフォーマンスの向上が望めます。
ncid	出力されたNetCDF ID.

エラー

エラーが発生していなければ、NF_OPEN は NF_NOERRの値を返します。それ以外の場合には、返されたステータスがエラーを示します。エラーの原因として下記が挙げられます。

･ 指定されたNetCDFファイルが存在しない。
･ 意味の無いモードが指定された。
例

この例は NF_OPEN を使って、既存のfoo.nc というNetCDFファイルを読取専用、非共有アクセス用にオープンします。

INCLUDE 'netcdf.inc'
…
INTEGER NCID, STATUS
…
STATUS = NF_OPEN('foo.nc', 0, NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)

Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com