Up|<<Prev|Next>>

6.4 次元の名前を変更する： nc_rename_dim

関数 nc_rename_dim は開かれた書きこみ状態にあるNetCDFファイル中の次元の名前を変更します。新しい名前が古い名前よりも長い場合にはNetCDFファイルは定義モードになければなりません。他に同名の次元がある場合にはその名前に変更することはできません。

 

int nc_rename_dim(int ncid, int dimid, const char* name);

 

ncid

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

dimid

以前の nc_inq_dimid 又は nc_def_dim 呼び出しによって返された次元 ID

name

新規の次元名。

 

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

 

この 例では nc_rename_dim を使用して既存のNetCDFファイル foo.nc 中の次元 lat を latitude に変更します：

#include <netcdf.h>
   ... 
int status, ncid, latid;
   ... 
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_dimid(ncid, "lat", &latid);
if (status != NC_NOERR) handle_error(status);
status = nc_rename_dim(ncid, latid, "latitude");
if (status != NC_NOERR) handle_error(status);
status = nc_enddef(ncid); /* 定義モードを抜ける */
if (status != NC_NOERR) handle_error(status);

Up|<<Prev|Next>>