6.4 次元の名前を変更する: NF_RENAME_DIM
関数NF_RENAME_DIM はオープンされた書きこみ状態にあるNetCDFファイル中の次元の名前を変更します。新しい名前が古い名前よりも長い場合にはNetCDFファイルは定義モードになければなりません。他に同名の次元がある場合にはその名前に変更することはできません。
用法
INTEGER FUNCTION NF_RENAME_DIM (INTEGER NCID, INTEGER DIMID,
CHARACTER*(*) NAME)
NCID 以前のNF_OPEN or NF_CREATE呼び出しで返されたNetCDF ID DIMID 以前のNF_INQ_DIMID または NF_DEF_DIM呼び出しによって返された次元ID NAME 新規の次元名
エラー
エラーが発生していない場合には関数NF_RENAME_DIM はNF_NOERR 値を返します。それ以外の場合には返されたステータスがエラーを示します。エラーの原因としては:
・ 新規の次元名がすでに他の次元名に使用されている。
・ 指定されたNetCDFファイルに対して次元IDが無効である。
・ 指定されたNetCDFID がオープンされているNetCDFファイルを参照していない。
・ 新規の次元名が旧次元名よりも長く、さらにNetCDFファイルが定義モードに入っていない。
例
この例では NF_RENAME_DIM を使用して既存のNetCDFファイルfoo.nc中の次元 latをlatitudeに変更します:
INCLUDE 'netcdf.inc'
…
INTEGER STATUS, NCID, LATID
…
STATUS = NF_OPEN('foo.nc', NF_WRITE, NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
…
! 次元の名前を変更するために定義モードに入る
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
STATUS = NF_INQ_DIMID(NCID, 'lat', LATID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
STATUS = NF_RENAME_DIM(NCID, LATID, 'latitude')
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 |