TOC PREV NEXT INDEX

Put your logo here!


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

・ 新規の次元名がすでに他の次元名に使用されている。
・ 指定されたNetCDFファイルに対して次元IDが無効である。
・ 指定されたNetCDFID がオープンされているNetCDFファイルを参照していない。
・ 新規の次元名が旧次元名よりも長く、さらにNetCDFファイルが定義モードに入っていない。

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

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