stdlib_strings 模块

此模块实现基本的字符串处理例程。

此模块的规范可在此处获得 此处.


使用

被使用


接口

公共接口 chomp

从字符串中删除集合中的尾部字符。如果未提供字符集，则删除尾部空格。

版本：实验性

  • 私有纯函数 chomp_string(string) result(chomped_string)

    从字符串中删除集合中的尾部字符。默认字符集变体，其中删除尾部空格。

    参数

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

    返回值 type(string_type)

  • 私有纯函数 chomp_char(string) result(chomped_string)

    从字符串中删除集合中的尾部字符。默认字符集变体，其中删除尾部空格。

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯函数 chomp_set_string_char(string, set) result(chomped_string)

    从字符串中删除集合中的尾部字符。

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    character(len=1), intent(in) :: set(:)

    返回值 type(string_type)

  • 私有纯函数 chomp_set_char_char(string, set) result(chomped_string)

    从字符串中删除集合中的尾部字符。

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    character(len=1), intent(in) :: set(:)

    返回值 character(len=:), allocatable

  • 私有纯函数 chomp_substring_string_string(string, substring) result(chomped_string)

    从字符串中删除尾部子字符串。

    参数

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

    返回值 type(string_type)

  • 私有纯函数 chomp_substring_char_string(string, substring) result(chomped_string)

    从字符串中删除尾部子字符串。

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯函数 chomp_substring_string_char(string, substring) result(chomped_string)

    从字符串中删除尾部子字符串。

    参数

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

    返回值 type(string_type)

  • 私有纯函数 chomp_substring_char_char(string, substring) result(chomped_string)

    从字符串中删除尾部子字符串。

    参数

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

    返回值 character(len=:), allocatable

公共接口 count

返回子字符串“pattern”在输入字符串“string”中出现的次数 规范

  • 私有元素函数 count_string_string(string, pattern, consider_overlapping) result(res)

    返回子字符串“pattern”在输入字符串“string”中出现的次数 返回一个整数

    参数

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

    返回值 integer

  • 私有元素函数 count_string_char(string, pattern, consider_overlapping) result(res)

    返回子字符串“pattern”在输入字符串“string”中出现的次数 返回一个整数

    参数

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

    返回值 integer

  • 私有元素函数 count_char_string(string, pattern, consider_overlapping) result(res)

    返回子字符串“pattern”在输入字符串“string”中出现的次数 返回一个整数

    参数

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

    返回值 integer

  • 私有元素函数 count_char_char(string, pattern, consider_overlapping) result(res)

    返回子字符串“pattern”在输入字符串“string”中出现的次数 返回一个整数

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    character(len=*), intent(in) :: pattern
    logical, intent(in), optional :: consider_overlapping

    返回值 integer

公共接口 ends_with

检查字符串是否以子字符串结尾

版本：实验性

  • 私有元素函数 ends_with_string_string(string, substring) result(match)

    检查字符串是否以子字符串结尾

    参数

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

    返回值 logical

  • 私有元素函数 ends_with_string_char(string, substring) result(match)

    检查字符串是否以子字符串结尾

    参数

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

    返回值 logical

  • 私有元素函数 ends_with_char_string(string, substring) result(match)

    检查字符串是否以子字符串结尾

    参数

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

    返回值 logical

  • 私有纯函数 ends_with_char_char(string, substring) result(match)

    检查字符串是否以子字符串结尾

    参数

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

    返回值 logical

公共接口 find

在输入“string”中查找子字符串“pattern”的起始索引 规范

版本：实验性

  • 私有元素函数 find_string_string(string, pattern, occurrence, consider_overlapping) result(res)

    返回输入“string”中子字符串“pattern”的第“occurrence”次出现的起始索引 返回一个整数

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    type(string_type), intent(in) :: pattern
    integer, intent(in), optional :: occurrence
    logical, intent(in), optional :: consider_overlapping

    返回值 integer

  • 私有元素函数 find_string_char(string, pattern, occurrence, consider_overlapping) result(res)

    返回输入“string”中子字符串“pattern”的第“occurrence”次出现的起始索引 返回一个整数

    参数

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

    返回值 integer

  • 私有元素函数 find_char_string(string, pattern, occurrence, consider_overlapping) result(res)

    返回输入“string”中子字符串“pattern”的第“occurrence”次出现的起始索引 返回一个整数

    参数

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

    返回值 integer

  • 私有元素函数 find_char_char(string, pattern, occurrence, consider_overlapping) result(res)

    返回输入“string”中子字符串“pattern”的第“occurrence”次出现的起始索引 返回一个整数

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    character(len=*), intent(in) :: pattern
    integer, intent(in), optional :: occurrence
    logical, intent(in), optional :: consider_overlapping

    返回值 integer

公共接口 padl

左填充输入字符串 规范

  • 私有纯函数 padl_string_default(string, output_length) result(res)

    用“ ”（1 个空格）左填充输入字符串

    返回一个新字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 padl_string_pad_with(string, output_length, pad_with) result(res)

    用“pad_with”字符左填充输入字符串

    返回一个新字符串

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    integer, intent(in) :: output_length
    character(len=1), intent(in) :: pad_with

    返回值 type(string_type)

  • 私有纯函数 padl_char_default(string, output_length) result(res)

    用“ ”（1 个空格）左填充输入字符串

    返回一个新字符串

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    integer, intent(in) :: output_length

    返回值 character(kind=output_length), len=max)

  • 私有纯函数 padl_char_pad_with(string, output_length, pad_with) result(res)

    用“pad_with”字符左填充输入字符串

    返回一个新字符串

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    integer, intent(in) :: output_length
    character(len=1), intent(in) :: pad_with

    返回值 character(kind=output_length), len=max)

公共接口 padr

右填充输入字符串 规范

  • 私有纯函数 padr_string_default(string, output_length) result(res)

    用“ ”（1 个空格）右填充输入字符串

    返回一个新字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 padr_string_pad_with(string, output_length, pad_with) result(res)

    用“pad_with”字符右填充输入字符串

    返回一个新字符串

    参数

    类型 意图可选 属性 名称
    type(string_type), intent(in) :: string
    integer, intent(in) :: output_length
    character(len=1), intent(in) :: pad_with

    返回值 type(string_type)

  • 私有纯函数 padr_char_default(string, output_length) result(res)

    用“ ”（1 个空格）右填充输入字符串

    返回一个新字符串

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    integer, intent(in) :: output_length

    返回值 character(kind=output_length), len=max)

  • 私有纯函数 padr_char_pad_with(string, output_length, pad_with) result(res)

    用“pad_with”字符右填充输入字符串

    返回一个新字符串

    参数

    类型 意图可选 属性 名称
    character(len=*), intent(in) :: string
    integer, intent(in) :: output_length
    character(len=1), intent(in) :: pad_with

    返回值 character(kind=output_length), len=max)

公共接口 replace_all

用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 版本：实验性

  • 私有纯函数 replace_all_string_string_string(string, pattern, replacement) result(res)

    用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 返回一个新字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 replace_all_string_string_char(string, pattern, replacement) result(res)

    用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 返回一个新字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 replace_all_string_char_string(string, pattern, replacement) result(res)

    用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 返回一个新字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 replace_all_char_string_string(string, pattern, replacement) 结果(res)

    用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 返回一个新字符串

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯函数 replace_all_string_char_char(string, pattern, replacement) 结果(res)

    用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 返回一个新字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 replace_all_char_string_char(string, pattern, replacement) 结果(res)

    用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 返回一个新字符串

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯函数 replace_all_char_char_string(string, pattern, replacement) 结果(res)

    用替换“replacement”替换输入“string”中子字符串“pattern”的所有出现 返回一个新字符串

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯函数 replace_all_char_char_char(string, pattern, replacement) 结果(res)

    替换输入 'string' 中所有出现的子字符串 'pattern' 为替换 'replacement'，返回一个新的字符串

    参数

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

    返回值 character(len=:), allocatable

公共接口 slice

从输入字符串中提取字符以返回一个新的字符串

版本：实验性

  • 私有元素函数 slice_string(string, first, last, stride) 结果(sliced_string)

    从输入 'string' 的 'first' 和 'last' 索引（包含）之间的区域提取字符，以 'stride' 的长度进行步进，返回一个新的字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 slice_char(string, first, last, stride) 结果(sliced_string)

    从输入 'string' 的 'first' 和 'last' 索引（包含）之间的区域提取字符，以 'stride' 的长度进行步进，返回一个新的字符串

    参数

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

    返回值 character(len=:), allocatable

公共接口 starts_with

检查字符串是否以子字符串开头

版本：实验性

  • 私有元素函数 starts_with_string_string(string, substring) 结果(match)

    检查字符串是否以子字符串开头

    参数

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

    返回值 logical

  • 私有元素函数 starts_with_string_char(string, substring) 结果(match)

    检查字符串是否以子字符串开头

    参数

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

    返回值 logical

  • 私有元素函数 starts_with_char_string(string, substring) 结果(match)

    检查字符串是否以子字符串开头

    参数

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

    返回值 logical

  • 私有纯函数 starts_with_char_char(string, substring) 结果(match)

    检查字符串是否以子字符串开头

    参数

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

    返回值 logical

公共接口 strip

删除前导和尾随空格字符。

版本：实验性

  • 私有纯函数 strip_string(string) 结果(stripped_string)

    删除前导和尾随空格字符。

    参数

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

    返回值 type(string_type)

  • 私有纯函数 strip_char(string) 结果(stripped_string)

    删除前导和尾随空格字符。

    参数

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

    返回值 character(len=:), allocatable

公共接口 to_string

格式化或将其他类型转换为字符串。 (规范)

  • 私有纯模块函数 to_string_1_i_int16(value) 结果(string)

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_1_i_int32(value) 结果(string)

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_1_i_int64(value) 结果(string)

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_1_i_int8(value) 结果(string)

    参数

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

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_1_l_lk(value) 结果(string)

    参数

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

    返回值 字符(len=1)

  • 私有纯模块函数 to_string_2_i_int16(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    整数(kind=int16), intent(in) :: value
    字符(len=*), intent(in) :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_2_i_int32(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    整数(kind=int32), intent(in) :: value
    字符(len=*), intent(in) :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_2_i_int64(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    整数(kind=int64), intent(in) :: value
    字符(len=*), intent(in) :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_2_i_int8(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    整数(kind=int8), intent(in) :: value
    字符(len=*), intent(in) :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_2_l_lk(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    逻辑(kind=lk), intent(in) :: value
    字符(len=*), intent(in) :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_c_dp(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    复数(kind=dp), intent(in) :: value
    字符(len=*), intent(in), optional :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_c_sp(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    复数(kind=sp), intent(in) :: value
    字符(len=*), intent(in), optional :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_r_dp(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    实数(kind=dp), intent(in) :: value
    字符(len=*), intent(in), optional :: format

    返回值 character(len=:), allocatable

  • 私有纯模块函数 to_string_r_sp(value, format) 结果(string)

    参数

    类型 意图可选 属性 名称
    实数(kind=sp), intent(in) :: value
    字符(len=*), intent(in), optional :: format

    返回值 character(len=:), allocatable

公共接口 zfill

用零填充输入字符串的左侧。 规范

  • 私有纯函数 zfill_string(string, output_length) 结果(res)

    用零填充输入字符串的左侧

    返回一个新字符串

    参数

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

    返回值 type(string_type)

  • 私有纯函数 zfill_char(string, output_length) 结果(res)

    用零填充输入字符串的左侧

    返回一个新字符串

    参数

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

    返回值 character(kind=output_length), len=max)