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

---

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

用法
int nc_open (const char *path, int omode, int *ncidp);

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

エラー

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

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

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

#include <netcdf.h>
…
int status;
int ncid;
…
status = nc_open("foo.nc", 0, &ncid);
if (status != NC_NOERR) hendle_error(status);

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