6.2 次元名から次元IDを取得する： NF_INQ_DIMID

---

関数 NF_INQ_DIMID は次元名を与えると、(引数として)NetCDFの次元IDを返します。仮に ndims あるNetCDFファイルに定義された次元数だとすると、それぞれの次元のIDは 1 と ndimsの間の値を取ります。

用法
INTEGER FUNCTION NF_INQ_DIMID (INTEGER NCID, CHARACTER*(*) NAME,
INTEGER dimid)

NCID	以前のNF_OPEN or NF_CREATE呼び出しで返されたNetCDF ID
NAME	次元名。アルファベットの文字で始まり、次にアンダースコア(‘_’)を含む0個以上の英数字が続きます。大文字小文字は次元名において区別されます
dimid	返された次元ID

エラー

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

･ 指定された次元名に対応する次元名がNetCDFファイル内に存在しない。
･ 指定されたNetCDF IDがオープンされたNetCDFファイルを参照していない。
例

これはNF_INQ_DIMID を使用して次元名latの次元IDを取得する例です。この latは以前にfoo.ncというNetCDFファイル内で定義されているという仮定です:

INCLUDE 'netcdf.inc'
…
INTEGER STATUS, NCID, LATID
…
STATUS = NF_OPEN('foo.nc', NF_NOWRITE, NCID)
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)

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