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

---

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

用法
INTEGER FUNCTION NF_RENAME_VAR (INTEGER NCID, INTEGER VARID,
CHARACTER*(*) NEWNAM)

NCID	以前のNF_OPENまたはNF_CREATE呼び出しで返されたNetCDF ID
VARID	変数ID
NEWNAM	指定された変数の新しい名前

エラー

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

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

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

INCLUDE 'netcdf.inc'
…
INTEGER STATUS, NCID
INTEGER RHID ! 変数ID
…
STATUS = NF_OPEN ('foo.nc', NF_WRITE, NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
…
STATUS = NF_REDEF (NCID) ! 定義モードに入る
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
STATUS = NF_INQ_VARID (NCID, 'rh', RHID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
STATUS = NF_RENAME_VAR (NCID, RHID, 'rel_hum')
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
STATUS = NF_ENDDEF (NCID) ! 定義モードを抜ける
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)

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