dc_url.f90

Go to the documentation of this file.

!-----------------------------------------------------------------------
! Copyright (c) 2000-2026 Gtool Development Group. All rights reserved.
!-----------------------------------------------------------------------
 
module dc_url
  implicit none
  private
 
  public:: url_chop_iorange
  public:: operator(.onthesamefile.)
 
  public:: urlmerge
  interface urlmerge
!    module procedure url_merge_v_vvv
    module procedure url_merge_cc
    module procedure url_merge_cccc
    module procedure url_merge_cccca
  end interface
 
  public:: urlsplit
  interface urlsplit
!    module procedure url_split_v
    module procedure url_split_c
  end interface
 
  public:: urlresolve
  interface urlresolve
    module procedure url_resolve_c
  end interface
 
  public:: urlsearchiorange
  interface urlsearchiorange
    module procedure url_search_iorange
  end interface
 
  interface operator(.onthesamefile.)
    module procedure urlonthesamefile
  end interface
 
  character, public, parameter:: gt_atmark = "@"
                                 ! ファイル名と変数名の区切りに用いられます。
  character, public, parameter:: gt_question = "?"
                                 ! ファイル名と変数名の区切りに用いられます。
  character, public, parameter:: gt_colon = ":"
                                 ! 変数の属性を示す時に用いられます。
  character, public, parameter:: gt_comma = ","
                                 ! 入出力範囲の限定に用いられます。
  character, public, parameter:: gt_equal = "="
                                 ! 入出力範囲の限定に用いられます。
  character, public, parameter:: gt_circumflex = "^"
                                 ! 座標の位置を値ではなく、
                                 ! 格子点番号で指定する時に用いられます。
  character, public, parameter:: gt_plus = "+"
                                 ! 属性の行頭にこの文字がつく場合、大域属性を示します。
 
contains
 
  ! ANUrlMerge - 変数 URL の合成
  ! 空文字列の成分はないとみなされる。
 
!  type(VSTRING) function &
!    & url_merge_v_vvv(file, var, attr, iorange) result(result) !:nodoc:
!    use dcstring_base, only: VSTRING, operator(.cat.), operator(/=), &
!      & extract, operator(==) !:nodoc:
!    implicit none
!    type(VSTRING), intent(in):: file
!    type(VSTRING), intent(in), optional:: var
!    type(VSTRING), intent(in), optional:: attr
!    type(VSTRING), intent(in), optional:: iorange
!    result = file .cat. GT_ATMARK
!    if (present(var)) result = result .cat. var
!    if (present(attr)) then
!      if (attr /= "") result = result .cat. GT_COLON .cat. attr
!    endif
!    if (present(iorange)) then
!      if (extract(iorange, 1, 1) == GT_COMMA) then
!        result = result .cat. iorange
!      else if (iorange /= "") then
!        result = result .cat. GT_COMMA .cat. iorange
!      endif
!    endif
!  end function
 
  function url_merge_cc(file, var) result(result)
    use dc_types, only: string
    character(len = STRING):: result
    character(len = *), intent(in):: file
    character(len = *), intent(in):: var
  continue
    result = url_merge_cccc(file, var, "", "")
  end function url_merge_cc
 
  function url_merge_cccca(file, var, attr, iorange) result(result)
    use dc_types, only: string
    character(len = STRING):: result
    character(len = *), intent(in):: file
    character(len = *), intent(in):: var
    character(len = *), intent(in):: attr
    character(len = *), intent(in):: iorange(:)
    integer:: i
  continue
    if (file /= "") then
      result = trim(file) // gt_atmark
    else
      result = gt_atmark
    endif
    if (var /= "") result = trim(result) // var
    if (attr /= "") then
      result = trim(result) // gt_colon // attr
    endif
    do i = 1, size(iorange)
      if (iorange(i) /= "") then
        if (iorange(i)(1:1) == gt_comma) then
          result = trim(result) // trim(iorange(i))
        else
          result = trim(result) // gt_comma // trim(iorange(i))
        endif
      endif
    end do
  end function url_merge_cccca
 
  function url_merge_cccc(file, var, attr, iorange) result(result)
    use dc_types, only: string
    character(len = STRING):: result
    character(len = *), intent(in):: file
    character(len = *), intent(in):: var
    character(len = *), intent(in):: attr
    character(len = *), intent(in):: iorange
  continue
    if (trim(file) /= "") then
      result = trim(file) // gt_atmark
    else
      result = gt_atmark
    endif
    if (trim(var) /= "") result = trim(result) // var
    if (trim(attr) /= "") then
      result = trim(result) // gt_colon // attr
    endif
    if (trim(iorange) /= "") then
      if (iorange(1:1) == gt_comma) then
        result = trim(result) // iorange
      else
        result = trim(result) // gt_comma // iorange
      endif
    endif
  end function url_merge_cccc
 
  subroutine url_chop_iorange(fullname, iorange, remainder)
    use dc_types, only: string
    character(len = *), intent(in):: fullname
    character(len = *), intent(out):: iorange   ! 入出力範囲指定部分
    character(len = *), intent(out):: remainder ! 残りの部分
    character(STRING):: file, var, attr
    call urlsplit(fullname, file=file, var=var, attr=attr, iorange=iorange)
    remainder = url_merge_cccc(file=file, var=var, attr=attr, iorange="")
  end subroutine url_chop_iorange
 
  function url_search_iorange(fullname, dimvar) result(result)
    use dc_types, only: string
    use dc_string, only: split
    character(len = *), intent(in):: fullname
    character(len = *), intent(in):: dimvar
    character(len = STRING):: result
    character(STRING):: file, var, attr, iorange
    character(STRING), pointer :: ioranges_slice(:) => null()
    integer :: i, eqpos, atmark
  continue
    result = ""
    ! @ または ? が含まれているなら urlsplit で分離
    atmark = index(fullname, gt_question)
    if (atmark == 0) atmark = index(fullname, gt_atmark)
    if (atmark /= 0) then
      call urlsplit(fullname, file=file, var=var, attr=attr, iorange=iorange)
    else
      iorange = fullname
    end if
    call split(iorange, ioranges_slice, gt_comma)
    do i = 1, size(ioranges_slice)
      eqpos = index(ioranges_slice(i), gt_equal)
      if (ioranges_slice(i)(1:eqpos-1) == trim(dimvar)) then
        result = trim(ioranges_slice(i)(eqpos+1:))
        exit
      end if
    end do
    deallocate(ioranges_slice)
  end function url_search_iorange
 
  subroutine url_split_c(fullname, file, var, attr, iorange)
    use dc_types, only: string
    character(len = *), intent(in):: fullname
    character(len = *), intent(out), optional:: file, var, attr, iorange
    character(len = STRING):: varpart
    integer:: atmark, colon, comma
    character(len = *), parameter:: VARNAME_SET &
      = "0123456789eEdD+-=^,.:_" &
      // "ABCDEFGHIJKLMNOPQRSTUVWXYZ" &
      // "abcdefghijklmnopqrstuvwxyz"
  continue
    ! まず URL と変数属性指定 (? または @ 以降) を分離する。
    ! URL は @ を含みうるため、最後の @ 以降に対して変数属性
    ! として許されない文字（典型的には '/'）が含まれていたら
    ! 当該 @ は URL の一部とみなす。
    atmark = index(fullname, gt_question)
    if (atmark == 0) then
      atmark = index(fullname, gt_atmark, back=.true.)
      if (atmark /= 0) then
        if (verify(trim(fullname(atmark+1: )), varname_set) /= 0) then
          atmark = 0
        endif
      endif
    endif
    if (atmark == 0) then
      ! 変数属性指定はなかった。
      if (present(file)) file = fullname
      if (present(var)) var = ''
      if (present(attr)) attr = ''
      if (present(iorange)) iorange = ''
      return
    endif
    varpart = fullname(atmark+1: )
    ! 変数属性指定があった。
    if (present(file)) file = fullname(1: atmark - 1)
    ! 範囲指定を探索する。
    comma = index(varpart, gt_comma)
    if (comma /= 0) then
      ! 範囲指定がみつかった。
      if (present(var)) var = varpart(1: comma - 1)
      if (present(attr)) attr = ''
      if (present(iorange)) iorange = varpart(comma + 1: )
      return
    endif
    if (present(iorange)) iorange = ''
    ! 範囲指定がなかったので、属性名の検索をする。
    colon = index(varpart, gt_colon)
    if (colon == 0) then
      if (present(var)) var = varpart
      if (present(attr)) attr = ''
      varpart = ''
      return
    endif
    if (present(var)) var = varpart(1: colon - 1)
    if (present(attr)) attr = varpart(colon + 1: )
    varpart = ''
  end subroutine url_split_c
 
!  subroutine url_split_v(fullname, file, var, attr, iorange) !:nodoc:
!    use dcstring_base, only: VSTRING, operator(.cat.), operator(/=), &
!      & extract, operator(==) !:nodoc:
!    use dc_string
!    implicit none
!    type(VSTRING), intent(in):: fullname
!    type(VSTRING), intent(out), optional::        file, var, attr, iorange
!    type(VSTRING):: varpart
!    integer:: atmark, colon, comma
!    character(len = *), parameter:: VARNAME_SET &
!      = "0123456789eEdD+-=^,.:_" &
!      // "ABCDEFGHIJKLMNOPQRSTUVWXYZ" &
!      // "abcdefghijklmnopqrstuvwxyz"
!  continue
!    ! まず URL と変数属性指定 (? または @ 以降) を分離する。
!    ! URL は @ を含みうるため、最後の @ 以降に対して変数属性
!    ! として許されない文字（典型的には '/'）が含まれていたら
!    ! 当該 @ は URL の一部とみなす。
!    atmark = vindex(fullname, GT_QUESTION)
!    if (atmark == 0) then
!      atmark = vindex(fullname, GT_ATMARK, .TRUE.)
!      if (atmark /= 0) then
!        varpart = extract(fullname, atmark + 1)
!        if (vverify(varpart, VARNAME_SET) /= 0) then
!          atmark = 0
!        endif
!      endif
!    endif
!    if (atmark == 0) then
!      ! 変数属性指定はなかった。
!      if (present(file)) file = fullname
!      if (present(var)) var = ''
!      if (present(attr)) attr = ''
!      if (present(iorange)) iorange = ''
!      return
!    endif
!    varpart = extract(fullname, atmark + 1)
!    ! 変数属性指定があった。
!    if (present(file)) file = extract(fullname, 1, atmark - 1)
!    ! 範囲指定を探索する。
!    comma = vindex(varpart, GT_COMMA)
!    if (comma /= 0) then
!      ! 範囲指定がみつかった。
!      if (present(var)) var = extract(varpart, 1, comma - 1)
!      if (present(attr)) attr = ''
!      if (present(iorange)) iorange = extract(varpart, comma + 1)
!      return
!    endif
!    if (present(iorange)) iorange = ''
!    ! 範囲指定がなかったので、属性名の検索をする。
!    colon = vindex(varpart, GT_COLON)
!    if (colon == 0) then
!      if (present(var)) var = varpart
!      if (present(attr)) attr = ''
!      varpart = ''
!      return
!    endif
!    if (present(var)) var = extract(varpart, 1, colon - 1)
!    if (present(attr)) attr = extract(varpart, colon + 1)
!    varpart = ''
!  end subroutine url_split_v
 
  logical function urlonthesamefile(url_a, url_b) result(result)
    use dc_string
    use dc_types, only: string
    character(len = *), intent(in) :: url_a
    character(len = *), intent(in) :: url_b
    character(len = STRING)        :: filepart_a
    character(len = STRING)        :: filepart_b
    call urlsplit(url_a, file=filepart_a)
    call urlsplit(url_b, file=filepart_b)
    result = (filepart_a == filepart_b)
  end function urlonthesamefile
 
  function url_resolve_c(relative, base) result(result)
    use dc_string, only: strhead
    use dc_types, only: string
    use dc_trace, only: beginsub, endsub, dbgmessage
    implicit none
    character(len = *), intent(in):: relative
    character(len = *), intent(in):: base
    character(len = STRING):: result
    integer, parameter:: file = 1, var = 2, attr = 3, ior = 4
    character(len = STRING):: rel(file:ior), bas(file:ior)
    character(3), parameter:: pathdelim = "/:" // achar(94)
    integer:: idir_r, idir_b
  continue
    call beginsub('urlresolve', 'rel=<%c> base=<%c>', c1=relative, c2=base)
    call urlsplit(trim(relative), file=rel(file), var=rel(var), &
      & attr=rel(attr), iorange=rel(ior))
    call dbgmessage('rel -> file=<%c> var=<%c> attr=<%c>', &
      & c1=trim(rel(file)), c2=trim(rel(var)), &
      & c3=(trim(rel(attr)) // '> ior=<' // trim(rel(ior))))
    call urlsplit(base, file=bas(file), var=bas(var), &
      & attr=bas(attr), iorange=bas(ior))
    call dbgmessage('base -> file=<%s> var=<%s> attr=<%s> ior=<%s>', &
      & c1=trim(bas(file)), c2=trim(bas(var)), &
      & c3=(trim(bas(attr)) // '> ior=<' // trim(bas(ior))))
    ! --- ファイル名を欠くばあいは単に補う ---
    if (rel(file) == "") then
      rel(file) = bas(file)
      if (rel(var) == "") &
        & rel(var) = bas(var)
      result = urlmerge(file=rel(file), var=rel(var), &
        & attr=rel(attr), iorange=rel(ior))
      call endsub('urlresolve', '1 result=%c', c1=trim(result))
      return
    endif
    ! --- 絶対パス (と見られる) ファイル名はそのまま使用 ---
    if (strhead(rel(file), "file:") &
      & .OR. strhead(rel(file), "http:") &
      & .OR. strhead(rel(file), "ftp:") &
      & .OR. strhead(rel(file), "news:") &
      & .OR. strhead(rel(file), "www") &
      & .OR. strhead(rel(file), "/") &
      & .OR. strhead(rel(file), achar(94)) &
      & .OR. rel(file)(2:2) == ":" &
      ) then
      result = relative
      call endsub('urlresolve', '2 result=%c', c1=trim(result))
      return
    endif
    ! ディレクトリ名の取り出し
    idir_b = scan(bas(file), pathdelim, back=.true.) 
    if (idir_b == 0) then
      ! が、できなければ、（エラーとすべきかもしれぬが）
      ! 相対パスをそのまま使用
      result = relative
      call endsub('urlresolve', '3 result=%c', c1=trim(result))
      return
    endif
    ! 相対パスのほうのディレクトリ名の取り出し
    idir_r = scan(rel(file), pathdelim, back=.true.)
    if (idir_r == 0) then
      ! ができなければ全体を使用
      idir_r = 1
    endif
    result = base(1: idir_b) // relative(idir_r: )
    call endsub('urlresolve', '4 result=%c', c1=trim(result))
  end function url_resolve_c
 
end module dc_url