Up|<<Prev|Next>>

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 値を返します。それ以外の場合には、返されたステータスがエラーの発生を示しています。エラーの原因としては：

 

この例では 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);

Up|<<Prev|Next>>