Up|<<Prev|Next>>

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

 

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

Up|<<Prev|Next>>