stdlib_string_type 模块

实现一个字符串类型,用于保存任意字符序列。

此模块提供与所有 Fortran 内在字符过程兼容的字符串类型,以及用于处理字符变量的重载运算符。

通过调用构造函数从字符变量或字面量创建新实例,或将其分配给字符串类型,可以轻松构造字符串类型。通常,字符串类型在大多数情况下类似于延迟长度字符,但增加了内存访问安全性。

此模块的规范可在此处找到 这里.



接口

公有接口 adjustl

将字符串表示的字符序列左对齐。字符序列的长度保持不变。

此方法是元素级的,并返回一个标量字符值。

  • 私有元素函数 adjustl_string(string) result(adjusted_string)

    将字符串表示的字符序列左对齐。字符序列的长度保持不变。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 adjustr

将字符串表示的字符序列右对齐。字符序列的长度保持不变。

此方法是元素级的,并返回一个标量字符值。

  • 私有元素函数 adjustr_string(string) result(adjusted_string)

    将字符串表示的字符序列右对齐。字符序列的长度保持不变。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 assignment(=)

将字符序列分配给字符串。

  • 私有元素子例程 assign_string_char(lhs, rhs)

    将字符序列分配给字符串。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(inout) :: lhs
    character(len=*), intent(in) :: rhs

公有接口 char

返回字符串表示的字符序列。

此方法是元素级的,并返回一个标量字符值。

  • 私有纯函数 char_string(string) result(character_string)

    返回字符串表示的字符序列。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string

    返回值 character(len=len)

  • 私有元素函数 char_string_pos(string, pos) result(character_string)

    返回字符串表示的字符序列。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    integer, intent(in) :: pos

    返回值 character(len=1)

  • 私有纯函数 char_string_range(string, start, last) result(character_string)

    返回字符串表示的字符序列。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    integer, intent(in) :: start
    integer, intent(in) :: last

    返回值 character(len=last)

公有接口 iachar

ASCII 排序顺序中的代码。

此方法是元素级的,并返回一个默认的整数标量值。

  • 私有元素函数 iachar_string(string) result(ich)

    ASCII 排序顺序中的代码。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string

    返回值 integer

公有接口 ichar

字符到整数转换函数。

此方法是元素级的,并返回一个默认的整数标量值。

  • 私有元素函数 ichar_string(string) result(ich)

    字符到整数转换函数。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string

    返回值 integer

公有接口 index

字符串子字符串的位置。

返回子字符串字符串中的最左端或最右端出现的起始位置,从 1 开始计数。如果子字符串不在字符串中,则返回 0。

此方法是元素级的,并返回一个默认的整数标量值。

  • 私有元素函数 index_string_string(string, substring, back) result(pos)

    字符序列中字符序列的位置。在此版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    type(string_type), intent(in) :: substring
    logical, intent(in), optional :: back

    返回值 integer

  • 私有元素函数 index_string_char(string, substring, back) result(pos)

    字符序列中字符序列的位置。在此版本中,主字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    character(len=*), intent(in) :: substring
    logical, intent(in), optional :: back

    返回值 integer

  • 私有元素函数 index_char_string(string, substring, back) result(pos)

    字符序列中字符序列的位置。在此版本中,子字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    type(string_type), intent(in) :: substring
    logical, intent(in), optional :: back

    返回值 integer

公有接口 len

返回字符串表示的字符序列的长度。

此方法是元素级的,并返回一个默认的整数标量值。

  • 私有元素函数 len_string(string) result(length)

    返回字符串表示的字符序列的长度。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string

    返回值 integer

公有接口 len_trim

返回字符串表示的字符序列的长度,不包括尾随空格。

此方法是元素级的,并返回一个默认的整数标量值。

  • 私有元素函数 len_trim_string(string) result(length)

    返回字符串表示的字符序列的长度,不包括尾随空格。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string

    返回值 integer

公有接口 lge

从词法上比较两个字符序列的顺序,判断是否大于等于。左侧、右侧或两个字符序列都可以由字符串表示。

此方法是元素级的,并返回一个默认的逻辑标量值。

  • 私有元素函数 lge_string_string(lhs, rhs) result(is_lge)

    从词法上比较两个字符序列,判断是否大于或等于。在此版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • 私有元素函数 lge_string_char(lhs, rhs) result(is_lge)

    从词法上比较两个字符序列,判断是否大于或等于。在此版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • 私有元素函数 lge_char_string(lhs, rhs) result(is_lge)

    从词法上比较两个字符序列,判断是否大于或等于。在此版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

公有接口 lgt

从词法上比较两个字符序列的顺序,判断是否大于。左侧、右侧或两个字符序列都可以由字符串表示。

此方法是元素级的,并返回一个默认的逻辑标量值。

  • 私有元素函数 lgt_string_string(lhs, rhs) result(is_lgt)

    从词法上比较两个字符序列,判断是否大于。在此版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • 私有元素函数 lgt_string_char(lhs, rhs) result(is_lgt)

    从词法上比较两个字符序列,判断是否大于。在此版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • 私有元素函数 lgt_char_string(lhs, rhs) result(is_lgt)

    从词法上比较两个字符序列,判断是否大于。在此版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

公有接口 lle

从词法上比较两个字符序列的顺序,判断是否小于等于。左侧、右侧或两个字符序列都可以由字符串表示。

此方法是元素级的,并返回一个默认的逻辑标量值。

  • 私有元素函数 lle_string_string(lhs, rhs) result(is_lle)

    从词法上比较两个字符序列,判断是否小于或等于。在此版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • 私有元素函数 lle_string_char(lhs, rhs) result(is_lle)

    词法比较两个字符序列,判断它们是否小于或等于。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function lle_char_string(lhs, rhs) result(is_lle)

    词法比较两个字符序列,判断它们是否小于或等于。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface llt

词法比较两个字符序列的顺序,判断它们是否小于。左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此方法是元素级的,并返回一个默认的逻辑标量值。

  • private elemental function llt_string_string(lhs, rhs) result(is_llt)

    词法比较两个字符序列,判断它们是否小于。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • private elemental function llt_string_char(lhs, rhs) result(is_llt)

    词法比较两个字符序列,判断它们是否小于。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function llt_char_string(lhs, rhs) result(is_llt)

    词法比较两个字符序列,判断它们是否小于。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface move

将分配的字符标量从'from'移动到'to' 规格

  • private elemental subroutine move_string_string(from, to)

    将分配的字符标量从'from'移动到'to'。没有输出。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(inout), target :: from
    type(string_type), intent(inout), target :: to
  • private pure subroutine move_string_char(from, to)

    将分配的字符标量从'from'移动到'to'。没有输出。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(inout) :: from
    character(len=:), intent(out), allocatable :: to
  • private pure subroutine move_char_string(from, to)

    将分配的字符标量从'from'移动到'to'。没有输出。

    参数

    类型 意图可选 属性 名称
    character(len=:), intent(inout), allocatable :: from
    type(string_type), intent(out) :: to
  • private pure subroutine move_char_char(from, to)

    将分配的字符标量从'from'移动到'to'。没有输出。

    参数

    类型 意图可选 属性 名称
    character(len=:), intent(inout), allocatable :: from
    character(len=:), intent(out), allocatable :: to

public interface operator(//)

连接两个字符序列,左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此运算符是元素运算符,返回一个标量字符值。

  • private elemental function concat_string_string(lhs, rhs) result(string)

    连接两个字符序列。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 type(string_type)

  • private elemental function concat_string_char(lhs, rhs) result(string)

    连接两个字符序列。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 type(string_type)

  • private elemental function concat_char_string(lhs, rhs) result(string)

    连接两个字符序列。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 type(string_type)

public interface operator(/=)

比较两个字符序列,判断它们是否不相等,左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此运算符是元素运算符,返回一个默认的逻辑标量值。

  • private elemental function ne_string_string(lhs, rhs) result(is_ne)

    比较两个字符序列,判断它们是否不相等。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • private elemental function ne_string_char(lhs, rhs) result(is_ne)

    比较两个字符序列,判断它们是否不相等。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function ne_char_string(lhs, rhs) result(is_ne)

    比较两个字符序列,判断它们是否不相等。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface operator(<)

比较两个字符序列,判断它们是否小于,左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此运算符是元素运算符,返回一个默认的逻辑标量值。

  • private elemental function lt_string_string(lhs, rhs) result(is_lt)

    比较两个字符序列,判断它们是否小于。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • private elemental function lt_string_char(lhs, rhs) result(is_lt)

    比较两个字符序列,判断它们是否小于。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function lt_char_string(lhs, rhs) result(is_lt)

    比较两个字符序列,判断它们是否小于。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface operator(<=)

比较两个字符序列,判断它们是否小于或等于,左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此运算符是元素运算符,返回一个默认的逻辑标量值。

  • private elemental function le_string_string(lhs, rhs) result(is_le)

    比较两个字符序列,判断它们是否小于或等于。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • private elemental function le_string_char(lhs, rhs) result(is_le)

    比较两个字符序列,判断它们是否小于或等于。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function le_char_string(lhs, rhs) result(is_le)

    比较两个字符序列,判断它们是否小于或等于。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface operator(==)

比较两个字符序列,判断它们是否相等,左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此运算符是元素运算符,返回一个默认的逻辑标量值。

  • private elemental function eq_string_string(lhs, rhs) result(is_eq)

    比较两个字符序列,判断它们是否相等。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • private elemental function eq_string_char(lhs, rhs) result(is_eq)

    比较两个字符序列,判断它们是否相等。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function eq_char_string(lhs, rhs) result(is_eq)

    比较两个字符序列,判断它们是否相等。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface operator(>)

比较两个字符序列,判断它们是否大于,左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此运算符是元素运算符,返回一个默认的逻辑标量值。

  • private elemental function gt_string_string(lhs, rhs) result(is_gt)

    比较两个字符序列,判断它们是否大于。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • private elemental function gt_string_char(lhs, rhs) result(is_gt)

    比较两个字符序列,判断它们是否大于。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function gt_char_string(lhs, rhs) result(is_gt)

    比较两个字符序列,判断它们是否大于。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface operator(>=)

比较两个字符序列,判断它们是否大于或等于,左侧字符序列、右侧字符序列或两个字符序列都可以由字符串表示。

此运算符是元素运算符,返回一个默认的逻辑标量值。

  • private elemental function ge_string_string(lhs, rhs) result(is_ge)

    比较两个字符序列,判断它们是否大于或等于。在这个版本中,两个字符序列都由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

  • private elemental function ge_string_char(lhs, rhs) result(is_ge)

    比较两个字符序列,判断它们是否大于或等于。在这个版本中,左侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: lhs
    character(len=*), intent(in) :: rhs

    返回值 logical

  • private elemental function ge_char_string(lhs, rhs) result(is_ge)

    比较两个字符序列,判断它们是否大于或等于。在这个版本中,右侧字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: lhs
    type(string_type), intent(in) :: rhs

    返回值 logical

public interface read(formatted)

从连接的非格式化单元读取字符序列到字符串中。

  • private subroutine read_formatted(string, unit, iotype, v_list, iostat, iomsg)

    从连接的格式化单元读取字符序列到字符串中。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(inout) :: string
    integer, intent(in) :: unit
    character(len=*), intent(in) :: iotype
    integer, intent(in) :: v_list(:)
    integer, intent(out) :: iostat
    character(len=*), intent(inout) :: iomsg

public interface read(unformatted)

从连接的非格式化单元读取字符序列到字符串中。

  • private subroutine read_unformatted(string, unit, iostat, iomsg)

    从连接的非格式化单元读取字符序列到字符串中。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(inout) :: string
    integer, intent(in) :: unit
    integer, intent(out) :: iostat
    character(len=*), intent(inout) :: iomsg

public interface repeat

将字符串中包含的字符序列重复指定次数。

此方法是元素级的,并返回一个标量字符值。

  • 私有元素函数 repeat_string(string, ncopies) 结果(repeated_string)

    将字符串中包含的字符序列重复指定次数。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string
    整数, intent(in) :: ncopies

    返回值 type(string_type)

公有接口 reverse

反转输入字符串持有的字符序列

此方法是元素方法,并返回一个新的 string_type 实例,其中包含此反转字符序列

  • 私有元素函数 reverse_string(string) 结果(reversed_string)

    反转输入字符串持有的字符序列

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 scan

string中扫描一组字符的存在。在string中扫描一组字符中的任何字符。

如果back不存在或为false,则此函数返回string中最左侧字符在set中的位置。如果backtrue,则返回最右侧位置。如果在string中找不到set中的任何字符,则结果为零。

此方法是元素级的,并返回一个默认的整数标量值。

  • 私有元素函数 scan_string_string(string, set, back) 结果(pos)

    扫描字符序列以查找一组字符中的任何字符。在此版本中,字符序列和字符集都由字符串表示。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string
    类型(string_type), intent(in) :: set
    逻辑, intent(in), optional :: back

    返回值 integer

  • 私有元素函数 scan_string_char(string, set, back) 结果(pos)

    扫描字符序列以查找一组字符中的任何字符。在此版本中,字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string
    字符(len=*), intent(in) :: set
    逻辑, intent(in), optional :: back

    返回值 integer

  • 私有元素函数 scan_char_string(string, set, back) 结果(pos)

    扫描字符序列以查找一组字符中的任何字符。在此版本中,字符集由字符串表示。

    参数

    类型 意图可选 属性 名称
    字符(len=*), intent(in) :: string
    类型(string_type), intent(in) :: set
    逻辑, intent(in), optional :: back

    返回值 integer

公有接口 string_type

用于新字符串实例的构造函数

  • 私有元素模块函数 new_string(string) 结果(new)

    参数

    类型 意图可选 属性 名称
    字符(len=*), intent(in), optional :: string

    返回值 type(string_type)

  • 私有元素模块函数 new_string_from_integer_int16(val) 结果(new)

    参数

    类型 意图可选 属性 名称
    整数(kind=int16), intent(in) :: val

    返回值 type(string_type)

  • 私有元素模块函数 new_string_from_integer_int32(val) 结果(new)

    参数

    类型 意图可选 属性 名称
    整数(kind=int32), intent(in) :: val

    返回值 type(string_type)

  • 私有元素模块函数 new_string_from_integer_int64(val) 结果(new)

    参数

    类型 意图可选 属性 名称
    整数(kind=int64), intent(in) :: val

    返回值 type(string_type)

  • 私有元素模块函数 new_string_from_integer_int8(val) 结果(new)

    参数

    类型 意图可选 属性 名称
    整数(kind=int8), intent(in) :: val

    返回值 type(string_type)

  • 私有元素模块函数 new_string_from_logical_lk(val) 结果(new)

    参数

    类型 意图可选 属性 名称
    逻辑(kind=lk), intent(in) :: val

    返回值 type(string_type)

公有接口 to_lower

返回输入字符串持有的字符序列的小写版本

此方法是元素方法,并返回一个新的 string_type 实例,其中包含此小写字符序列

  • 私有元素函数 to_lower_string(string) 结果(lowercase_string)

    将输入字符串持有的字符序列转换为小写

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 to_sentence

返回输入字符串持有的字符序列的句子大小写版本

此方法是元素方法,并返回一个新的 string_type 实例,其中包含此句子大小写字符序列

  • 私有元素函数 to_sentence_string(string) 结果(sentence_string)

    将输入字符串持有的字符序列转换为句子大小写

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 to_title

返回输入字符串持有的字符序列的标题大小写版本

此方法是元素方法,并返回一个新的 string_type 实例,其中包含此标题大小写字符序列

  • 私有元素函数 to_title_string(string) 结果(titlecase_string)

    将输入字符串持有的字符序列转换为标题大小写

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 to_upper

返回输入字符串持有的字符序列的大写版本

此方法是元素方法,并返回一个新的 string_type 实例,其中包含此大写字符序列

  • 私有元素函数 to_upper_string(string) 结果(uppercase_string)

    将输入字符串持有的字符序列转换为大写

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 trim

返回字符串持有的字符序列,不带尾随空格。

此方法是元素级的,并返回一个标量字符值。

  • 私有元素函数 trim_string(string) 结果(trimmed_string)

    返回字符串持有的字符序列,不带尾随空格。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string

    返回值 type(string_type)

公有接口 verify

扫描字符串以查找一组字符的缺失。验证字符串中的所有字符是否都属于集合中的字符集。

如果back不存在或为false,则此函数返回string中最左侧字符不在set中的位置。如果backtrue,则返回最右侧位置。如果在string中找到了所有set中的字符,则结果为零。

此方法是元素级的,并返回一个默认的整数标量值。

  • 私有元素函数 verify_string_string(string, set, back) 结果(pos)

    验证字符序列以查找一组字符中的任何字符的缺失。在此版本中,字符序列和字符集都由字符串表示。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string
    类型(string_type), intent(in) :: set
    逻辑, intent(in), optional :: back

    返回值 integer

  • 私有元素函数 verify_string_char(string, set, back) 结果(pos)

    验证字符序列以查找一组字符中的任何字符的缺失。在此版本中,字符序列由字符串表示。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string
    字符(len=*), intent(in) :: set
    逻辑, intent(in), optional :: back

    返回值 integer

  • 私有元素函数 verify_char_string(string, set, back) 结果(pos)

    验证字符序列以查找一组字符中的任何字符的缺失。在此版本中,字符集由字符串表示。

    参数

    类型 意图可选 属性 名称
    字符(len=*), intent(in) :: string
    类型(string_type), intent(in) :: set
    逻辑, intent(in), optional :: back

    返回值 integer

公有接口 write(formatted)

将字符串持有的字符序列写入已连接的格式化单元。

  • 私有子程序 write_formatted(string, unit, iotype, v_list, iostat, iomsg)

    将字符串持有的字符序列写入已连接的格式化单元。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string
    整数, intent(in) :: unit
    字符(len=*), intent(in) :: iotype
    整数, intent(in) :: v_list(:)
    整数, intent(out) :: iostat
    字符(len=*), intent(inout) :: iomsg

公有接口 write(unformatted)

将字符串持有的字符序列写入已连接的非格式化单元。

  • 私有子程序 write_unformatted(string, unit, iostat, iomsg)

    将字符串持有的字符序列写入已连接的非格式化单元。

    参数

    类型 意图可选 属性 名称
    类型(string_type), intent(in) :: string
    整数, intent(in) :: unit
    整数, intent(out) :: iostat
    字符(len=*), intent(inout) :: iomsg

派生类型

类型, 公有, 序列  ::  string_type

字符串类型,保存任意字符序列。

构造函数

用于新字符串实例的构造函数

私有元素, 模块函数 new_string (string)
私有元素, 模块函数 new_string_from_integer_int16 (val)
私有元素, 模块函数 new_string_from_integer_int32 (val)
私有元素, 模块函数 new_string_from_integer_int64 (val)
私有元素, 模块函数 new_string_from_integer_int8 (val)
私有元素, 模块函数 new_string_from_logical_lk (val)