Up|<<Prev|Next>>


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

次元名。アルファベットの文字で始まり、次に零もしくはアンダースコア( `_' )を含む英数字列が続く。大文字小文字は次元名において区別される。

dimid

返された次元ID

 

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

 

これは 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)

Up|<<Prev|Next>>