5.6 オープンされたNetCDFファイルを定義モードにする: nc_redef

---

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

用法
int nc_redef(int ncid);

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

エラー

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

･ 指定されたNetCDFファイルが既に定義モードにある。
･ 指定された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);

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