strings Module

private pure elemental function string_adjustl(x) result(rst)

Adjusts the string to the left by removing any leading blanks and pushing any removed blanks onto the end of the string.

Arguments

Return Value type(string)

The adjusted string.

private pure elemental function string_adjustr(x) result(rst)

Adjusts the string to the right by removing any trailing blanks and pushing any removed blanks onto the front of the string.

Arguments

Return Value type(string)

The adjusted string.

private elemental subroutine string_to_char(lhs, rhs)

Assigns a string to a character array.

Arguments

private elemental subroutine char_to_string(lhs, rhs)

Assigns a character array to a string type.

Arguments

private pure function string_convert_to_char(x) result(rst)

Converts a string to a Fortran character array.

Arguments

Return Value character(len=:), allocatable

The resulting string.

private pure function char_find_char(str, substr) result(rst)

Finds the starting index of all substrings within a parent string.

Arguments

Return Value integer(kind=int32), allocatable, dimension(:)

An array containing the starting index of each occurrence of substr in str.

private pure function char_find_str(str, substr) result(rst)

Finds the starting index of all substrings within a parent string.

Arguments

Return Value integer(kind=int32), allocatable, dimension(:)

An array containing the starting index of each occurrence of substr in str.

private pure function str_find_char(str, substr) result(rst)

Finds the starting index of all substrings within a parent string.

Arguments

Return Value integer(kind=int32), allocatable, dimension(:)

An array containing the starting index of each occurrence of substr in str.

private pure function str_find_str(str, substr) result(rst)

Finds the starting index of all substrings within a parent string.

Arguments

Return Value integer(kind=int32), allocatable, dimension(:)

An array containing the starting index of each occurrence of substr in str.

private pure elemental function string_index_string(str, substr, back) result(rst)

Returns the starting position of a substring within a string.

Arguments

Return Value integer(kind=int32)

The starting index of the substring.

private pure elemental function string_index_char(str, substr, back) result(rst)

Returns the starting position of a substring within a string.

Arguments

Return Value integer(kind=int32)

The starting index of the substring.

private pure elemental function char_index_string(str, substr, back) result(rst)

Returns the starting position of a substring within a string.

Arguments

Return Value integer(kind=int32)

The starting index of the substring.

private pure elemental function char_insert_char(str, start, substr) result(rst)

Inserts a substring into another string at the specified index.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_insert_string(str, start, substr) result(rst)

Inserts a substring into another string at the specified index.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_insert_char(str, start, substr) result(rst)

Inserts a substring into another string at the specified index.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_insert_string(str, start, substr) result(rst)

Inserts a substring into another string at the specified index.

Arguments

Return Value type(string)

The resulting string.

private pure function string_len(x) result(rst)

Returns the length of a string.

Arguments

Return Value integer(kind=int32)

The length of the string.

private pure function string_len_trim(x) result(rst)

Returns the length of a string.

Arguments

Return Value integer(kind=int32)

The length of the string.

private pure elemental function concat_strings(lhs, rhs) result(rst)

Concatenates two strings.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function concat_char_string(lhs, rhs) result(rst)

Concatenates two strings.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function concat_string_char(lhs, rhs) result(rst)

Concatenates two strings.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_neq_string(lhs, rhs) result(rst)

Tests two strings for inequality.

Arguments

Return Value logical

True if the strings are not equal; else, false.

private pure elemental function char_neq_string(lhs, rhs) result(rst)

Tests two strings for inequality.

Arguments

Return Value logical

True if the strings are not equal; else, false.

private pure elemental function string_neq_char(lhs, rhs) result(rst)

Tests two strings for inequality.

Arguments

Return Value logical

True if the strings are not equal; else, false.

private pure elemental function string_eq_string(lhs, rhs) result(rst)

Tests two strings for equality.

Arguments

Return Value logical

True if the strings are equal; else, false.

private pure elemental function char_eq_string(lhs, rhs) result(rst)

Tests two strings for equality.

Arguments

Return Value logical

True if the strings are equal; else, false.

private pure elemental function string_eq_char(lhs, rhs) result(rst)

Tests two strings for equality.

Arguments

Return Value logical

True if the strings are equal; else, false.

private pure elemental function remove_char(str, start, finish) result(rst)

Removes a range of characters from the string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function remove_string(str, start, finish) result(rst)

Removes a range of characters from the string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_remove_char(str, substr) result(rst)

Removes the first occurrence of the specified substring from the string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_remove_string(str, substr) result(rst)

Removes the first occurrence of the specified substring from the string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_remove_char(str, substr) result(rst)

Removes the first occurrence of the specified substring from the string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_remove_string(str, substr) result(rst)

Removes the first occurrence of the specified substring from the string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_replace_char_char(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_replace_char_string(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_replace_string_char(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_replace_string_string(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_replace_char_char(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_replace_char_string(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_replace_string_char(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_replace_string_string(src, old, substr) result(rst)

Replaces all instances of a substring within a parent string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_scan_string(str, substr, back) result(rst)

Scans the string for any of the characters in the specified substring.

Arguments

Return Value integer(kind=int32)

The index of either the leftmost or rightmost character.

private pure elemental function string_scan_char(str, substr, back) result(rst)

Scans the string for any of the characters in the specified substring.

Arguments

Return Value integer(kind=int32)

The index of either the leftmost or rightmost character.

private pure elemental function char_scan_string(str, substr, back) result(rst)

Scans the string for any of the characters in the specified substring.

Arguments

Return Value integer(kind=int32)

The index of either the leftmost or rightmost character.

private pure function split_string_char(txt, delim) result(rst)

Splits a string by the supplied delimiter character.

Arguments

Return Value type(string), allocatable, dimension(:)

An array containing the resulting sub-strings.

private pure function split_string_str(txt, delim) result(rst)

Splits a string by the supplied delimiter character.

Arguments

Return Value type(string), allocatable, dimension(:)

An array containing the resulting sub-strings.

private pure function string_to_int_char(x) result(rst)

Converts a string to a 32-bit integer.

Arguments

Return Value integer(kind=int32)

The resulting integer.

private pure function string_to_int_string(x) result(rst)

Converts a string to a 32-bit integer.

Arguments

Return Value integer(kind=int32)

The resulting integer.

private pure function string_to_real_char(x) result(rst)

Converts a string to a 64-bit real.

Arguments

Return Value real(kind=real64)

The resulting value.

private pure function string_to_real_string(x) result(rst)

Converts a string to a 64-bit real.

Arguments

Return Value real(kind=real64)

The resulting value.

private pure function char_to_c_string(x) result(rst)

Converts a Fortran string to a C-compatible, null-terminated string.

Arguments

Return Value character(kind=c_char, len=1), allocatable, dimension(:)

The resulting C string.

private pure function string_to_c_string(x) result(rst)

Converts a Fortran string to a C-compatible, null-terminated string.

Arguments

Return Value character(kind=c_char, len=1), allocatable, dimension(:)

The resulting C string.

private pure function to_lower_char(x) result(rst)

Converts a string to all lowercase characters. Any characters that are already lowercase, a special symbol, or a numeric value are not modified.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function to_lower_string(x) result(rst)

Converts a string to all lowercase characters. Any characters that are already lowercase, a special symbol, or a numeric value are not modified.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function char_convert_to_string(x) result(rst)

Converts a Fortran character array to a string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function int8_to_string(x) result(rst)

Converts an 8-bit integer to a string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function int16_to_string(x) result(rst)

Converts a 16-bit integer to a string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function int32_to_string(x) result(rst)

Converts a 32-bit integer to a string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function int64_to_string(x) result(rst)

Converts a 64-bit integer to a string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function real32_to_string(x, fmt) result(rst)

Converts a 32-bit real to a string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function real64_to_string(x, fmt) result(rst)

Converts a 64-bit real to a string.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function real128_to_string(x, fmt) result(rst)

Converts a 128-bit real to a string.

Arguments

Return Value type(string)

The resulting string.

private pure function c_string_to_string(str, nchar) result(rst)

Converts an array of C characters (C string) to a string. The C string must be null-terminated. The null-terimator character will not be included in the result.

Arguments

Return Value type(string)

private pure function to_upper_char(x) result(rst)

Converts a string to all uppercase characters. Any characters that are already uppercase, a special symbol, or a numeric value are not modified.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function to_upper_string(x) result(rst)

Converts a string to all uppercase characters. Any characters that are already uppercase, a special symbol, or a numeric value are not modified.

Arguments

Return Value type(string)

The resulting string.

private pure elemental function string_trim(x) result(rst)

Trims any trailing blanks from the end of the string.

Arguments

Return Value type(string)

The trimmed string.