dc_url Module Reference

Variable URL string parser. More...

Data Types
interface	urlmerge
interface	urlsplit
interface	urlresolve
interface	urlsearchiorange
interface	operator(.onthesamefile.)

Functions/Subroutines
subroutine, public	url_chop_iorange (fullname, iorange, remainder)

Variables
character, parameter, public	gt_atmark = "@"
character, parameter, public	gt_question = "?"
character, parameter, public	gt_colon = ":"
character, parameter, public	gt_comma = ","
character, parameter, public	gt_equal = "="
character, parameter, public	gt_circumflex = "^"
character, parameter, public	gt_plus = "+"

Detailed Description

Variable URL string parser.

Author

Youhei SASAKI, Yasuhiro MORIKAWA, Eizi TOYODA

Copyright

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

This module provides procedures for parsing gtool4 variable URL strings.

See "5. Various String Formats" of gtool4 netCDF convention for variable URL format.

Procedures Summary

Procedure	Description
UrlSplit	Split variable URL to filename, variable name, attribute name and I/O range
UrlMerge	Merge filename, variable name, attribute name and I/O range to variable URL
UrlResolve	Complement variable URL
Url_Chop_IOrange	Remove iorange from variable URL
UrlSearchIORange	Get I/O range value for a dimension from variable URL
operator(.OnTheSameFile.)	Check if two variable URLs point to the same file

This module provides mnemonics for special characters in gtool4 variables. When parsing gtool4 variables, use the variables provided here (GT_ATMARK, etc.) instead of using characters directly.

Function/Subroutine Documentation

url_chop_iorange()

subroutine, public dc_url::url_chop_iorange	(	character(len = *), intent(in)	fullname,
		character(len = *), intent(out)	iorange,
		character(len = *), intent(out)	remainder )

Remove I/O range from variable URL

Separates the I/O range specification part and the remaining part from the variable URL given in fullname, and returns them in iorange and remainder respectively.

Parameters

[in]	fullname	Variable URL
[out]	iorange	I/O range specification part
[out]	remainder	Remaining part

Definition at line 300 of file dc_url.f90.

    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="")

References dc_types::string.

Variable Documentation

gt_atmark

character, parameter, public dc_url::gt_atmark = "@"

Definition at line 96 of file dc_url.f90.

  character, public, parameter:: GT_ATMARK = "@"

gt_circumflex

character, parameter, public dc_url::gt_circumflex = "^"

Definition at line 106 of file dc_url.f90.

  character, public, parameter:: GT_CIRCUMFLEX = "^"

gt_colon

character, parameter, public dc_url::gt_colon = ":"

Definition at line 100 of file dc_url.f90.

  character, public, parameter:: GT_COLON = ":"

gt_comma

character, parameter, public dc_url::gt_comma = ","

Definition at line 102 of file dc_url.f90.

  character, public, parameter:: GT_COMMA = ","

gt_equal

character, parameter, public dc_url::gt_equal = "="

Definition at line 104 of file dc_url.f90.

  character, public, parameter:: GT_EQUAL = "="

gt_plus

character, parameter, public dc_url::gt_plus = "+"

Definition at line 109 of file dc_url.f90.

  character, public, parameter:: GT_PLUS = "+"

gt_question

character, parameter, public dc_url::gt_question = "?"

Definition at line 98 of file dc_url.f90.

  character, public, parameter:: GT_QUESTION = "?"