TOC PREV NEXT INDEX

Put your logo here!


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_varNC_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
TOC PREV NEXT INDEX