-5.6 開かれたNetCDFファイルを定義モードにする: nc

関数 nc_redef は開かれたNetCDFファイルを定義モードにし、次元・変数・属性などを付加又はそれらの名前を変更し、さらに属性を削除できるようにする。

int nc_redef(int ncid);

ncid

以前の nc_open 又は nc_create 呼び出しで返されたNetCDF ID。。

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

指定されたNetCDFファイルは読取専用に開かれている。

指定されたNetCDF IDが開かれたNetCDFファイルを参照していない。

この例では nc_redef を使って、既存の foo.nc というNetCDFファイルを開き、それを定義モードにする。

#include <netcdf.h>

...

int status;

int ncid;

...

status = nc_open("foo.nc", NC_WRITE, &ncid);  /* ファイルを開く */

if (status != NC_NOERR) handle_error(status);

...

status = nc_redef(ncid);                      /* 定義モードに入る */

if (status != NC_NOERR) handle_error(status);