7.17 変数の名前を変更する: nc_rename_var

---

関数nc_rename_varはオープンされたNetCDFファイルのNetCDF変数の名前を変更します。もし新しい名前が以前の名前よりも長い場合にはNetCDFファイルは定義モードになっていなければなりません。既に存在している変数名に変更することはできません。

用法
int nc_rename_var(int ncid, int varid, const char* name);

ncid	以前のnc_openまたはnc_create呼び出しで返されたNetCDF ID
varid	変数ID
name	指定された変数の新しい名前

エラー

エラーが発生していなければ、関数nc_rename_varはNC_NOERR値を返します。それ以外の場合には、返されたステータスがエラーの発生を示しています。エラーの原因としては：

･ 新しい名前が他の変数の名前として既に使用されている。
･ 変数IDが指定されたNetCDFファイルで有効ではない。
･ 指定されたNetCDF IDがオープンされたNetCDFファイルを参照しない。
例

この例ではnc_rename_varを使用して、既存のNetCDFファイルfoo.nc内の変数rhの名前をrel_humに変更します。

#include <netcdf.h>
…
int status; /* エラーステータス */
int ncid; /* NetCDF ID */
int rh_id; /* 変数 ID */
…
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);
status = nc_inq_varid (ncid, "rh", &rh_id);
if (status != NC_NOERR) handle_error(status);
status = nc_rename_var (ncid, rh_id, "rel_hum");
if (status != NC_NOERR) handle_error(status);
status = nc_enddef(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