gdncvaropenbydimord.f90 File Reference

Open netCDF dimension variable by dimension order . More...

Go to the source code of this file.

Functions/Subroutines
subroutine	gdncvaropenbydimord (var, src_var, dimord, err)

Detailed Description

Open netCDF dimension variable by dimension order

.

Author

Yasuhiro MORIKAWA, Eizi TOYODA

Copyright

Copyright (C) GFD Dennou Club, 2000-2026. All rights reserved.
License is BSD-2-Clause. See COPYRIGHT in detail

Definition in file gdncvaropenbydimord.f90.

Function/Subroutine Documentation

gdncvaropenbydimord()

subroutine gdncvaropenbydimord	(	type(gd_nc_variable), intent(out)	var,
		type(gd_nc_variable), intent(in)	src_var,
		integer, intent(in)	dimord,
		logical, intent(out), optional	err
	)

Open the dimension variable at specified position

Opens the variable corresponding to the dimord-th dimension of an already opened variable src_var, and stores it in var.

On error, outputs a message and terminates the program. If err is provided, it returns .true. instead of terminating.

Parameters

[out]	var	Opened dimension variable
[in]	src_var	Source variable
[in]	dimord	Dimension order (1-based)
[out]	err	Error flag (optional)

Definition at line 42 of file gdncvaropenbydimord.f90.

  use gtdata_netcdf_types, only: gd_nc_variable, gd_nc_variable_entry, gd_nc_variable_search
  use gtdata_netcdf_internal, only: vtable_lookup, vtable_add
  use gtdata_netcdf_file_generic, only: gdncfilereopen, gdncfileclose
  use netcdf, only: nf90_max_name, nf90_noerr, nf90_einval, nf90_enotvar, &
    & nf90_inquire_dimension, nf90_inq_varid
  use dc_error
  implicit none
  type(GD_NC_VARIABLE), intent(out):: var
  type(GD_NC_VARIABLE), intent(in):: src_var
  integer, intent(in):: dimord
  logical, intent(out), optional:: err
  type(GD_NC_VARIABLE_ENTRY):: src_ent
  type(GD_NC_VARIABLE_SEARCH):: ent
  character(len = NF90_MAX_NAME):: dimname
  integer:: stat
continue
  stat = vtable_lookup(src_var, src_ent)
  if (stat /= nf90_noerr) goto 999
  !
  if (dimord <= 0) then
    !
    ! dimord == 0 の特別扱いは廃止 (gtdata 層でやる)。
    ! (同じハンドルを返すと参照カウントが増えないので多重クローズが
    ! 禁止されてしまい、Open のセマンティクスに不適合なため。)
    !
    var = src_var
    stat = nf90_einval
    goto 999
  endif
  if (.not. associated(src_ent%dimids)) then
    stat = gt_enomoredims
    goto 999
  else if (dimord > size(src_ent%dimids)) then
    stat = gt_enomoredims
    goto 999
  endif
  !
  ! 決定された次元 id を使って変数 id の確定を試みる
  !
  ent%fileid = src_ent%fileid
  ent%dimid = src_ent%dimids(dimord)
  stat = nf90_inquire_dimension(ent%fileid, ent%dimid, name = dimname)
  if (stat /= nf90_noerr) goto 999
  stat = nf90_inq_varid(ent%fileid, dimname, ent%varid)
  if (stat == nf90_enotvar) then
    ! 変数が対応しなければ無視するだけ
    ent%varid = 0
    stat = nf90_noerr
  else if (stat /= nf90_noerr) then
    goto 999
  endif
  !
  ! 成功しそうなので参照カウント値を増やす
  call gdncfilereopen(ent%fileid)
  ! 不適合な変数が開かれている場合は vtable_add が変数部を無視する。
  stat = vtable_add(var, ent)
  if (stat /= nf90_noerr) then
    call gdncfileclose(ent%fileid)
    goto 999
  endif
 
999 continue
  call storeerror(stat, 'GDNcVarOpenByDimOrd', err, cause_i=dimord)

References dc_error::gt_enomoredims, dc_error::storeerror(), gtdata_netcdf_internal::vtable_add(), and gtdata_netcdf_internal::vtable_lookup().

Here is the call graph for this function: