musica_string::string_t Type Reference
Generic string type. More...
Public Member Functions | |
| procedure | length (this) |
| Returns the string length. | |
| procedure | to_upper (this) |
| Converts a string to upper case. | |
| procedure | to_lower (this) |
| Converts a string to lower case. | |
| procedure | substring (this, start_index, length) |
| Gets a substring. | |
| procedure | replace (this, from, to) |
| Replaces substrings within a string. | |
| procedure | to_char (this) |
| Converts a string to a character array. | |
| procedure | pack_size (this, comm) |
| Returns the size of a binary buffer required to pack the string. | |
| procedure | mpi_pack (this, buffer, position, comm) |
| Packs the string onto a character buffer. | |
| procedure | mpi_unpack (this, buffer, position, comm) |
| Unpacks the string from a character buffer. | |
Public Attributes | |
| character(len=:), allocatable | val_ |
| the string | |
String assignment | |
| procedure, pass(to), private | string_assign_char (to, from) |
| Assigns a string from a character array. | |
| procedure, pass(to), private | string_assign_int (to, from) |
| Assigns a string from an integer. | |
| procedure, pass(to), private | string_assign_real (to, from) |
| Assigns a string from a real number. | |
| procedure, pass(to), private | string_assign_double (to, from) |
| Assigns a string from a double precision real number. | |
| procedure, pass(to), private | string_assign_logical (to, from) |
| Assigns a string from a logical. | |
| procedure, pass(from), private | char_assign_string (to, from) |
| Assign a character array from a string. | |
| procedure, pass(from), private | real_assign_string (to, from) |
| Assign a real from a string. | |
| procedure, pass(from), private | double_assign_string (to, from) |
| Assign a double precision real from a string. | |
| procedure, pass(from), private | int_assign_string (to, from) |
| Assign an integer from a string. | |
| procedure, pass(from), private | logical_assign_string (to, from) |
| Assigns a logical from a string. | |
| generic | assignment (to, from) |
| Assigns a string from a character array. | |
| generic | assignment (to, from) |
| Assigns a string from an integer. | |
| generic | assignment (to, from) |
| Assigns a string from a real number. | |
| generic | assignment (to, from) |
| Assigns a string from a double precision real number. | |
| generic | assignment (to, from) |
| Assigns a string from a logical. | |
| generic | assignment (to, from) |
| Assign a character array from a string. | |
| generic | assignment (to, from) |
| Assign a real from a string. | |
| generic | assignment (to, from) |
| Assign a double precision real from a string. | |
| generic | assignment (to, from) |
| Assign an integer from a string. | |
| generic | assignment (to, from) |
| Assigns a logical from a string. | |
Joins to a string | |
| procedure, pass(a), private | string_join_string (a, b) |
| Joins a string to a string. | |
| procedure, pass(a), private | string_join_char (a, b) |
| Joins a string to a character array. | |
| procedure, pass(a), private | string_join_int (a, b) |
| Joins a string to an integer. | |
| procedure, pass(a), private | string_join_real (a, b) |
| Joins a string to a real number. | |
| procedure, pass(a), private | string_join_double (a, b) |
| Joins a string to a double precision real number. | |
| procedure, pass(a), private | string_join_logical (a, b) |
| Joins a string to a logical. | |
| procedure, pass(b), private | char_join_string (a, b) |
| Joins a character array to a string. | |
| procedure, pass(b), private | int_join_string (a, b) |
| Joins an integer to a string. | |
| procedure, pass(b), private | real_join_string (a, b) |
| Joins a real number to a string. | |
| procedure, pass(b), private | double_join_string (a, b) |
| Joins a double precision real number to a string. | |
| procedure, pass(b), private | logical_join_string (a, b) |
| Joins a logical to a string. | |
| generic | operator (a, b) |
| Joins a string to a string. | |
| generic | operator (a, b) |
| Joins a string to a character array. | |
| generic | operator (a, b) |
| Joins a string to an integer. | |
| generic | operator (a, b) |
| Joins a string to a real number. | |
| generic | operator (a, b) |
| Joins a string to a double precision real number. | |
| generic | operator (a, b) |
| Joins a string to a logical. | |
| generic | operator (a, b) |
| Joins a character array to a string. | |
| generic | operator (a, b) |
| Joins an integer to a string. | |
| generic | operator (a, b) |
| Joins a real number to a string. | |
| generic | operator (a, b) |
| Joins a double precision real number to a string. | |
| generic | operator (a, b) |
| Joins a logical to a string. | |
String equality | |
| procedure, pass(a), private | string_equals_string (a, b) |
| Compares a string to a string for equality. | |
| procedure, pass(a), private | string_equals_char (a, b) |
| Compares a string to a character array for equality. | |
| procedure, pass(a), private | string_equals_int (a, b) |
| Compares a string to a integer for equality. | |
| procedure, pass(a), private | string_equals_real (a, b) |
| Compares a string to a real number for equality. | |
| procedure, pass(a), private | string_equals_double (a, b) |
| Compares a string to a double-precision real number for equality. | |
| procedure, pass(a), private | string_equals_logical (a, b) |
| Compares a string to a logical for equality. | |
| procedure, pass(b), private | char_equals_string (a, b) |
| Compares a character array to a string for equality. | |
| procedure, pass(b), private | int_equals_string (a, b) |
| Compares an integer to a string for equality. | |
| procedure, pass(b), private | real_equals_string (a, b) |
| Compares a real number to a string for equality. | |
| procedure, pass(b), private | double_equals_string (a, b) |
| Compares a double-precision real number to a string for equality. | |
| procedure, pass(b), private | logical_equals_string (a, b) |
| Compares a logical to a string for equality. | |
| procedure, pass(a), private | string_not_equals_string (a, b) |
| Compares a string to a string for equality. | |
| procedure, pass(a), private | string_not_equals_char (a, b) |
| Compares a string to a character array for equality. | |
| procedure, pass(a), private | string_not_equals_int (a, b) |
| Compares a string to a integer for equality. | |
| procedure, pass(a), private | string_not_equals_real (a, b) |
| Compares a string to a real number for equality. | |
| procedure, pass(a), private | string_not_equals_double (a, b) |
| Compares a string to a double-precision real number for equality. | |
| procedure, pass(a), private | string_not_equals_logical (a, b) |
| Compares a string to a logical for equality. | |
| procedure, pass(b), private | char_not_equals_string (a, b) |
| Compares a character array to a string for equality. | |
| procedure, pass(b), private | int_not_equals_string (a, b) |
| Compares an integer to a string for equality. | |
| procedure, pass(b), private | real_not_equals_string (a, b) |
| Compares a real number to a string for equality. | |
| procedure, pass(b), private | double_not_equals_string (a, b) |
| Compares a double-precision real number to a string for equality. | |
| procedure, pass(b), private | logical_not_equals_string (a, b) |
| Compares a logical to a string for equality. | |
| generic | operator (a, b) |
| Compares a string to a string for equality. | |
| generic | operator (a, b) |
| Compares a string to a character array for equality. | |
| generic | operator (a, b) |
| Compares a string to a integer for equality. | |
| generic | operator (a, b) |
| Compares a string to a real number for equality. | |
| generic | operator (a, b) |
| Compares a string to a double-precision real number for equality. | |
| generic | operator (a, b) |
| Compares a string to a logical for equality. | |
| generic | operator (a, b) |
| Compares a character array to a string for equality. | |
| generic | operator (a, b) |
| Compares an integer to a string for equality. | |
| generic | operator (a, b) |
| Compares a real number to a string for equality. | |
| generic | operator (a, b) |
| Compares a double-precision real number to a string for equality. | |
| generic | operator (a, b) |
| Compares a logical to a string for equality. | |
| generic | operator (a, b) |
| Compares a string to a string for equality. | |
| generic | operator (a, b) |
| Compares a string to a character array for equality. | |
| generic | operator (a, b) |
| Compares a string to a integer for equality. | |
| generic | operator (a, b) |
| Compares a string to a real number for equality. | |
| generic | operator (a, b) |
| Compares a string to a double-precision real number for equality. | |
| generic | operator (a, b) |
| Compares a string to a logical for equality. | |
| generic | operator (a, b) |
| Compares a character array to a string for equality. | |
| generic | operator (a, b) |
| Compares an integer to a string for equality. | |
| generic | operator (a, b) |
| Compares a real number to a string for equality. | |
| generic | operator (a, b) |
| Compares a double-precision real number to a string for equality. | |
| generic | operator (a, b) |
| Compares a logical to a string for equality. | |
Splits a string on a sub-string | |
| procedure, private | split_char (this, splitter, compress) |
| Splits a string on a substring. | |
| procedure, private | split_string (this, splitter, compress) |
| Splits a string on a substring. | |
| generic | split (this, splitter, compress) |
| Splits a string on a substring. | |
| generic | split (this, splitter, compress) |
| Splits a string on a substring. | |
Detailed Description
Generic string type.
Member Function/Subroutine Documentation
◆ assignment() [1/10]
| generic musica_string::string_t::assignment | ( | class(string_t), intent(out) | to, |
| character(len=*), intent(in) | from ) |
Assigns a string from a character array.
- Parameters
-
[out] to String to assign [in] from New string value
◆ assignment() [2/10]
| generic musica_string::string_t::assignment | ( | class(string_t), intent(out) | to, |
| integer(kind=musica_ik), intent(in) | from ) |
Assigns a string from an integer.
- Parameters
-
[out] to String to assign [in] from New string value
◆ assignment() [3/10]
| generic musica_string::string_t::assignment | ( | class(string_t), intent(out) | to, |
| real(kind=musica_rk), intent(in) | from ) |
Assigns a string from a real number.
- Parameters
-
[out] to String to assign [in] from New string value
◆ assignment() [4/10]
| generic musica_string::string_t::assignment | ( | class(string_t), intent(out) | to, |
| real(kind=musica_dk), intent(in) | from ) |
Assigns a string from a double precision real number.
- Parameters
-
[out] to String to assign [in] from New string value
◆ assignment() [5/10]
| generic musica_string::string_t::assignment | ( | class(string_t), intent(out) | to, |
| logical, intent(in) | from ) |
Assigns a string from a logical.
- Parameters
-
[out] to String to assign [in] from New string value
◆ assignment() [6/10]
| generic musica_string::string_t::assignment | ( | character(len=*), intent(inout) | to, |
| class(string_t), intent(in) | from ) |
Assign a character array from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ assignment() [7/10]
| generic musica_string::string_t::assignment | ( | real(kind=musica_rk), intent(inout) | to, |
| class(string_t), intent(in) | from ) |
Assign a real from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ assignment() [8/10]
| generic musica_string::string_t::assignment | ( | real(kind=musica_dk), intent(inout) | to, |
| class(string_t), intent(in) | from ) |
Assign a double precision real from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ assignment() [9/10]
| generic musica_string::string_t::assignment | ( | integer(kind=musica_ik), intent(inout) | to, |
| class(string_t), intent(in) | from ) |
Assign an integer from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ assignment() [10/10]
| generic musica_string::string_t::assignment | ( | logical, intent(inout) | to, |
| class(string_t), intent(in) | from ) |
Assigns a logical from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ char_assign_string()
|
private |
Assign a character array from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ char_equals_string()
|
private |
Compares a character array to a string for equality.
- Parameters
-
[in] a Character array a [in] b String b
◆ char_join_string()
|
private |
Joins a character array to a string.
- Returns
- Joined string
- Parameters
-
[in] a Character array to join [in] b String to join
◆ char_not_equals_string()
|
private |
Compares a character array to a string for equality.
- Parameters
-
[in] a Character array a [in] b String b
◆ double_assign_string()
|
private |
Assign a double precision real from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ double_equals_string()
|
private |
Compares a double-precision real number to a string for equality.
- Parameters
-
[in] a Double-precision real number a [in] b String b
◆ double_join_string()
|
private |
Joins a double precision real number to a string.
- Returns
- Joined string
- Parameters
-
[in] a Double precision real number to join [in] b String to join
◆ double_not_equals_string()
|
private |
Compares a double-precision real number to a string for equality.
- Parameters
-
[in] a Double-precition real number a [in] b String b
◆ int_assign_string()
|
private |
Assign an integer from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ int_equals_string()
|
private |
Compares an integer to a string for equality.
- Parameters
-
[in] a Integer a [in] b String b
◆ int_join_string()
|
private |
Joins an integer to a string.
- Returns
- Joined string
- Parameters
-
[in] a Integer to join [in] b String to join
◆ int_not_equals_string()
|
private |
Compares an integer to a string for equality.
- Parameters
-
[in] a Integer a [in] b String b
◆ length()
| procedure musica_string::string_t::length | ( | class(string_t), intent(in) | this | ) |
Returns the string length.
- Parameters
-
[in] this String
◆ logical_assign_string()
|
private |
Assigns a logical from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ logical_equals_string()
|
private |
Compares a logical to a string for equality.
- Parameters
-
[in] a Logical a [in] b String b
◆ logical_join_string()
|
private |
Joins a logical to a string.
- Returns
- Joined string
- Parameters
-
[in] a Logical to join [in] b String to join
◆ logical_not_equals_string()
|
private |
Compares a logical to a string for equality.
- Parameters
-
[in] a Logical a [in] b String b
◆ mpi_pack()
| procedure musica_string::string_t::mpi_pack | ( | class(string_t), intent(in) | this, |
| character, dimension(:), intent(inout) | buffer, | ||
| integer, intent(inout) | position, | ||
| integer, intent(in) | comm ) |
Packs the string onto a character buffer.
- Parameters
-
[in] this String to pack [in,out] buffer Memory buffer [in,out] position Current buffer position [in] comm MPI communicator
◆ mpi_unpack()
| procedure musica_string::string_t::mpi_unpack | ( | class(string_t), intent(out) | this, |
| character, dimension(:), intent(inout) | buffer, | ||
| integer, intent(inout) | position, | ||
| integer, intent(in) | comm ) |
Unpacks the string from a character buffer.
- Parameters
-
[out] this String to be unpacked [in,out] buffer Memory buffer [in,out] position Current buffer position [in] comm MPI communicator
◆ operator() [1/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Joins a string to a string.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b String to join
◆ operator() [2/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| character(len=*), intent(in) | b ) |
Joins a string to a character array.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Character array to join
◆ operator() [3/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| integer(kind=musica_ik), intent(in) | b ) |
Joins a string to an integer.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Integer to join
◆ operator() [4/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| real(kind=musica_rk), intent(in) | b ) |
Joins a string to a real number.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Real number to join
◆ operator() [5/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| real(kind=musica_dk), intent(in) | b ) |
Joins a string to a double precision real number.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Double precision real number to join
◆ operator() [6/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| logical, intent(in) | b ) |
Joins a string to a logical.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Logical to join
◆ operator() [7/33]
| generic musica_string::string_t::operator | ( | character(len=*), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Joins a character array to a string.
- Returns
- Joined string
- Parameters
-
[in] a Character array to join [in] b String to join
◆ operator() [8/33]
| generic musica_string::string_t::operator | ( | integer(kind=musica_ik), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Joins an integer to a string.
- Returns
- Joined string
- Parameters
-
[in] a Integer to join [in] b String to join
◆ operator() [9/33]
| generic musica_string::string_t::operator | ( | real(kind=musica_rk), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Joins a real number to a string.
- Returns
- Joined string
- Parameters
-
[in] a Real number to join [in] b String to join
◆ operator() [10/33]
| generic musica_string::string_t::operator | ( | real(kind=musica_dk), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Joins a double precision real number to a string.
- Returns
- Joined string
- Parameters
-
[in] a Double precision real number to join [in] b String to join
◆ operator() [11/33]
| generic musica_string::string_t::operator | ( | logical, intent(in) | a, |
| class(string_t), intent(in) | b ) |
Joins a logical to a string.
- Returns
- Joined string
- Parameters
-
[in] a Logical to join [in] b String to join
◆ operator() [12/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a string to a string for equality.
- Parameters
-
[in] a String a [in] b String b
◆ operator() [13/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| character(len=*), intent(in) | b ) |
Compares a string to a character array for equality.
- Parameters
-
[in] a String a [in] b Character array b
◆ operator() [14/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| integer(kind=musica_ik), intent(in) | b ) |
Compares a string to a integer for equality.
- Parameters
-
[in] a String a [in] b Integer b
◆ operator() [15/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| real(kind=musica_rk), intent(in) | b ) |
Compares a string to a real number for equality.
- Parameters
-
[in] a String a [in] b Real number b
◆ operator() [16/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| real(kind=musica_dk), intent(in) | b ) |
Compares a string to a double-precision real number for equality.
- Parameters
-
[in] a String a [in] b Double-precition real number b
◆ operator() [17/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| logical, intent(in) | b ) |
Compares a string to a logical for equality.
- Parameters
-
[in] a String a [in] b Logical b
◆ operator() [18/33]
| generic musica_string::string_t::operator | ( | character(len=*), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a character array to a string for equality.
- Parameters
-
[in] a Character array a [in] b String b
◆ operator() [19/33]
| generic musica_string::string_t::operator | ( | integer(kind=musica_ik), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares an integer to a string for equality.
- Parameters
-
[in] a Integer a [in] b String b
◆ operator() [20/33]
| generic musica_string::string_t::operator | ( | real(kind=musica_rk), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a real number to a string for equality.
- Parameters
-
[in] a Real number a [in] b String b
◆ operator() [21/33]
| generic musica_string::string_t::operator | ( | real(kind=musica_dk), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a double-precision real number to a string for equality.
- Parameters
-
[in] a Double-precision real number a [in] b String b
◆ operator() [22/33]
| generic musica_string::string_t::operator | ( | logical, intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a logical to a string for equality.
- Parameters
-
[in] a Logical a [in] b String b
◆ operator() [23/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a string to a string for equality.
- Parameters
-
[in] a String a [in] b String b
◆ operator() [24/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| character(len=*), intent(in) | b ) |
Compares a string to a character array for equality.
- Parameters
-
[in] a String a [in] b Character array b
◆ operator() [25/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| integer(kind=musica_ik), intent(in) | b ) |
Compares a string to a integer for equality.
- Parameters
-
[in] a String a [in] b Integer b
◆ operator() [26/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| real(kind=musica_rk), intent(in) | b ) |
Compares a string to a real number for equality.
- Parameters
-
[in] a String a [in] b Real number b
◆ operator() [27/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| real(kind=musica_dk), intent(in) | b ) |
Compares a string to a double-precision real number for equality.
- Parameters
-
[in] a String a [in] b Double-precition real number b
◆ operator() [28/33]
| generic musica_string::string_t::operator | ( | class(string_t), intent(in) | a, |
| logical, intent(in) | b ) |
Compares a string to a logical for equality.
- Parameters
-
[in] a String a [in] b Logical b
◆ operator() [29/33]
| generic musica_string::string_t::operator | ( | character(len=*), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a character array to a string for equality.
- Parameters
-
[in] a Character array a [in] b String b
◆ operator() [30/33]
| generic musica_string::string_t::operator | ( | integer(kind=musica_ik), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares an integer to a string for equality.
- Parameters
-
[in] a Integer a [in] b String b
◆ operator() [31/33]
| generic musica_string::string_t::operator | ( | real(kind=musica_rk), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a real number to a string for equality.
- Parameters
-
[in] a Real number a [in] b String b
◆ operator() [32/33]
| generic musica_string::string_t::operator | ( | real(kind=musica_dk), intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a double-precision real number to a string for equality.
- Parameters
-
[in] a Double-precition real number a [in] b String b
◆ operator() [33/33]
| generic musica_string::string_t::operator | ( | logical, intent(in) | a, |
| class(string_t), intent(in) | b ) |
Compares a logical to a string for equality.
- Parameters
-
[in] a Logical a [in] b String b
◆ real_assign_string()
|
private |
Assign a real from a string.
- Parameters
-
[in,out] to Variable to assign [in] from String to assign from
◆ real_equals_string()
|
private |
Compares a real number to a string for equality.
- Parameters
-
[in] a Real number a [in] b String b
◆ real_join_string()
|
private |
Joins a real number to a string.
- Returns
- Joined string
- Parameters
-
[in] a Real number to join [in] b String to join
◆ real_not_equals_string()
|
private |
Compares a real number to a string for equality.
- Parameters
-
[in] a Real number a [in] b String b
◆ replace()
| procedure musica_string::string_t::replace | ( | class(string_t) | this, |
| character(len=*), intent(in) | from, | ||
| character(len=*), intent(in) | to ) |
Replaces substrings within a string.
Example:
type(string_t) :: my_string
my_string =
my_string = my_string%replace( 'foo', 'bar' )
write(*,*) my_string
Output:
bar bar barbar
- Returns
- String with replacements
- Parameters
-
this Original string [in] from Sub-string to replace [in] to Replacement string
◆ split() [1/2]
| generic musica_string::string_t::split | ( | class(string_t), intent(in) | this, |
| character(len=*), intent(in) | splitter, | ||
| logical, intent(in), optional | compress ) |
Splits a string on a substring.
Example:
type(string_t) :: my_string
type(string_t), allocatable :: sub_strings(:)
integer :: i
my_string =
sub_strings = my_string%split( ' ' )
do i = 1, size( sub_strings )
write(*,*) i, sub_strings( i )
end do
sub_strings = my_string%split( ' ', .true. )
do i = 1, size( sub_strings )
write(*,*) i, sub_strings( i )
end do
Output:
1 my
2 original
3
4
5
6 string
1 my
2 original
3 string
- Returns
- Split string
- Parameters
-
[in] this Full string [in] splitter String to split on [in] compress Compress (default = false)
No 0-length substrings will be returned (adjacent tokens will be merged; tokens at the beginning and end of the original string will be ignored)
◆ split() [2/2]
| generic musica_string::string_t::split | ( | class(string_t), intent(in) | this, |
| type(string_t), intent(in) | splitter, | ||
| logical, intent(in), optional | compress ) |
Splits a string on a substring.
See string_split_char for description and example
- Returns
- Split string
- Parameters
-
[in] this Full string [in] splitter String to split on [in] compress Compress (default = false)
No 0-length substrings will be returned (adjacent tokens will be merged; tokens at the beginning and end of the original string will be ignored)
◆ split_char()
|
private |
Splits a string on a substring.
Example:
type(string_t) :: my_string
type(string_t), allocatable :: sub_strings(:)
integer :: i
my_string =
sub_strings = my_string%split( ' ' )
do i = 1, size( sub_strings )
write(*,*) i, sub_strings( i )
end do
sub_strings = my_string%split( ' ', .true. )
do i = 1, size( sub_strings )
write(*,*) i, sub_strings( i )
end do
Output:
1 my
2 original
3
4
5
6 string
1 my
2 original
3 string
- Returns
- Split string
- Parameters
-
[in] this Full string [in] splitter String to split on [in] compress Compress (default = false)
No 0-length substrings will be returned (adjacent tokens will be merged; tokens at the beginning and end of the original string will be ignored)
◆ split_string()
|
private |
Splits a string on a substring.
See string_split_char for description and example
- Returns
- Split string
- Parameters
-
[in] this Full string [in] splitter String to split on [in] compress Compress (default = false)
No 0-length substrings will be returned (adjacent tokens will be merged; tokens at the beginning and end of the original string will be ignored)
◆ string_assign_char()
|
private |
Assigns a string from a character array.
- Parameters
-
[out] to String to assign [in] from New string value
◆ string_assign_double()
|
private |
Assigns a string from a double precision real number.
- Parameters
-
[out] to String to assign [in] from New string value
◆ string_assign_int()
|
private |
Assigns a string from an integer.
- Parameters
-
[out] to String to assign [in] from New string value
◆ string_assign_logical()
|
private |
Assigns a string from a logical.
- Parameters
-
[out] to String to assign [in] from New string value
◆ string_assign_real()
|
private |
Assigns a string from a real number.
- Parameters
-
[out] to String to assign [in] from New string value
◆ string_equals_char()
|
private |
Compares a string to a character array for equality.
- Parameters
-
[in] a String a [in] b Character array b
◆ string_equals_double()
|
private |
Compares a string to a double-precision real number for equality.
- Parameters
-
[in] a String a [in] b Double-precition real number b
◆ string_equals_int()
|
private |
Compares a string to a integer for equality.
- Parameters
-
[in] a String a [in] b Integer b
◆ string_equals_logical()
|
private |
Compares a string to a logical for equality.
- Parameters
-
[in] a String a [in] b Logical b
◆ string_equals_real()
|
private |
Compares a string to a real number for equality.
- Parameters
-
[in] a String a [in] b Real number b
◆ string_equals_string()
|
private |
Compares a string to a string for equality.
- Parameters
-
[in] a String a [in] b String b
◆ string_join_char()
|
private |
Joins a string to a character array.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Character array to join
◆ string_join_double()
|
private |
Joins a string to a double precision real number.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Double precision real number to join
◆ string_join_int()
|
private |
Joins a string to an integer.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Integer to join
◆ string_join_logical()
|
private |
Joins a string to a logical.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Logical to join
◆ string_join_real()
|
private |
Joins a string to a real number.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b Real number to join
◆ string_join_string()
|
private |
Joins a string to a string.
- Returns
- Joined string
- Parameters
-
[in] a String to join [in] b String to join
◆ string_not_equals_char()
|
private |
Compares a string to a character array for equality.
- Parameters
-
[in] a String a [in] b Character array b
◆ string_not_equals_double()
|
private |
Compares a string to a double-precision real number for equality.
- Parameters
-
[in] a String a [in] b Double-precition real number b
◆ string_not_equals_int()
|
private |
Compares a string to a integer for equality.
- Parameters
-
[in] a String a [in] b Integer b
◆ string_not_equals_logical()
|
private |
Compares a string to a logical for equality.
- Parameters
-
[in] a String a [in] b Logical b
◆ string_not_equals_real()
|
private |
Compares a string to a real number for equality.
- Parameters
-
[in] a String a [in] b Real number b
◆ string_not_equals_string()
|
private |
Compares a string to a string for equality.
- Parameters
-
[in] a String a [in] b String b
◆ substring()
| procedure musica_string::string_t::substring | ( | class(string_t), intent(in) | this, |
| integer(kind=musica_ik), intent(in) | start_index, | ||
| integer(kind=musica_ik), intent(in) | length ) |
Gets a substring.
Example:
type(string_t) :: my_string, sub_string
my_string =
sub_string = my_string%substring( 4, 5 )
write(*,*) sub_string
sub_string = my_string%substring( 9, 50 )
write(*,*) sub_string
Output:
there
!
- Parameters
-
[in] this Full string [in] start_index Starting character index [in] length Length of the substring to return
◆ to_char()
| procedure musica_string::string_t::to_char | ( | class(string_t), intent(in) | this | ) |
Converts a string to a character array.
- Returns
- Converted string
- Parameters
-
[in] this String to convert
◆ to_lower()
| procedure musica_string::string_t::to_lower | ( | class(string_t), intent(in) | this | ) |
Converts a string to lower case.
Adapted from http://www.star.le.ac.uk/~cgp/fortran.html (25 May 2012) Original author: Clive Page
- Returns
- Converted string
- Parameters
-
[in] this String to convert
◆ to_upper()
| procedure musica_string::string_t::to_upper | ( | class(string_t), intent(in) | this | ) |
Converts a string to upper case.
Adapted from http://www.star.le.ac.uk/~cgp/fortran.html (25 May 2012) Original author: Clive Page
- Returns
- Converted string
- Parameters
-
[in] this String to convert
The documentation for this type was generated from the following file:
- /home/docs/checkouts/readthedocs.org/user_builds/tuv-x/checkouts/latest/src/util/string.F90
Generated by
1.13.2