TOC PREV NEXT INDEX

Put your logo here!


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_openNC_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
TOC PREV NEXT INDEX