Up|<<Prev|Next>>

6.1 次元を生成する: NF_DEF_DIM

関数 NF_DEF_DIM 等は定義モード中であれば、新しい次元を開かれたNetCDFファイルに加えることが出来る。 NetCDFのID、次元名、次元長を与えると、（引数として）次元IDを返す。最大で一つの無制限次元（記録次元）がNetCDFファイルごとに定義できる

用法

INTEGER FUNCTION NF_DEF_DIM (INTEGER NCID, CHARACTER*(*) NAME,

                          INTEGER LEN, INTEGER dimid)
 

NCID

以前の NF_OPEN or NF_CREATE 呼び出しで返されたNetCDF ID。

NAME

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

LEN

次元長。この次元をインデックスとして使用する変数に対して、この次元が持ちうる値の数量。正の整数（ size_t型）もしくは事前に定義された定数 NF_UNLIMITED である。

dimid

返された次元ID。

 

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

 

これは NF_DEF_DIM 機能を使用して次元名 lat 次元長18、そして次元名 rec 次元長無制限の二つの次元を持つ新しい foo.nc というNetCDFファイルを生成する例です：

INCLUDE 'netcdf.inc'
   ... 
INTEGER STATUS, NCID, LATID, RECID
   ... 
STATUS = NF_CREATE('foo.nc', NF_NOCLOBBER, NCID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
   ... 
STATUS = NF_DEF_DIM(NCID, 'lat', 18, LATID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)
STATUS = NF_DEF_DIM(NCID, 'rec', NF_UNLIMITED, RECID)
IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)

Up|<<Prev|Next>>