String.Custom.Data

Source of Chars

Returns String as a Source of [Char]] "abcd".char_~ tp // Prints ~(a, x, c, d)

Char at position

Returns Char at the specified position

Char at position

Optionally Returns Char at the specified position

/ is returned if specified position is out of String range

if(<name>.charAt_?(2).take(_.isUpper)) ()
// is equivalent
if(<name>.length >=2 && <name>.charAt(2).isUpper) ()

Char index

Optionally returns index of the first Char passing the let function

   "abcd_abcd_".charIndex_?(_ >= 'd', 4) tp // Prints: ?(8)
   "abcd_abcd_".charIndex_?('x' <> 'z') tp  // Prints: \/

Contains check

Returns true is this String contains that String "abc".contains("cd") tp // Prints: false

Check if ends with

Returns true this String ends with that String "abc".endsWith("bc") tp // Prints: true

Check if equals ignore case

Returns true this and that String are equal, if upper and lower case Chars are considered equal "aBc".equalsIgnoreCase("ABC").tp // Prints: true

Indents text with the lines

Indents text with the tag.

Prefixes first line with the tag, other lines with tag equal space

```
   "abc

de xyz".indent("Idxs: ").tp // Output Idxs: abc de xyz ```

Source of indexes

Source of indexes for each occurrence of x "abcd_abcd_abcd_abcd_abcd".indexesOf_~("bc") tp // Prints ~(1, 6, 11, 16, 21)

Value position

Optionally returns position of the specified x "abcd_abcd_".indexOf_?("d_a") tp // Prints: ?(3)

Type to Info

Override this method to provide type standard Info implementation

Insert at position

Creates new String with x inserted at the specified position "0123456789".insertAt(5,"abc") tp // Prints: 01234abc56789

Capitalize

Capitalizes first character of every word (separated by white spaces) "all string ops".tag tp // Prints: All String Ops

Char index

Optionally returns index of the last Char passing the let function

   "abcd_abcd_".lastCharIndex_?(_ >= 'd', 4) tp // Prints: ?(3)
   "abcd_abcd_".lastCharIndex_?('x' <> 'z') tp  // Prints: \/

Value position

Optionally returns last position of the specified x "abcd_abcd_abcd_".lastIndexOf_?("d_a") tp // Prints: ?(8)

Source of lines

Creates a [[Source]] of Strings representing lines (delimited by '

') of this text

```  "abc

def xyz".line_~.tp // Prints ~(abc, def, xyz) ```

toLowerCase

Creates new String with all upper case Chars changed to lower case "ABc".lower tp // Prints: abc

Pad end

Pads end of string to targetLength

Pad start

Pads start of string to targetLength

Remove all

Creates new String with all occurrences of x removed "123123123123".remove("2") tp // Prints: 13131313

Replace all

Creates new String with all occurrences of x replaced with target "123123123123".replace("2","_") tp // Prints: 1_31_31_31_3

Replace range with x

Creates new String with all occurrences of x replaced with target "0123456789".replace(3 <> 7 ,"_") tp // Prints: 012_89

Check if begins with

Returns true this String starts with that String "abc".startsWith("ab") tp // Prints: true

Copy end

Copies String from the position where the specified x found plus the length of the x

If no x found, dflt x is returned, or original if dflt is void

   "abcdefg".copyAfter("cd") tp // Prints: efg

Copy end

Copies String from the last position the specified x found plus the length of the x

If no x found, dflt x is returned, or original if dflt is void.

   "abcd_abcd_abcd".takeFromLast("ab") tp // Prints: cd

Copy start

Copies String from the beginning until specified x found

If no x found, dflt x is returned, or original if dflt is void

   "abcdefg".takeBefore("ef") tp // Prints: abcd

Copy start

Copies String from the beginning until the last occurrence of specified x found

If no x found, dflt x is returned, or original if dflt is void

   "abcd_abcd_abcd".copyBeforeLast("ab") tp // Prints: abcd_abcd_

Copy end

Copies String from the position where the specified x found

If no x found, dflt x is returned, or original if dflt is void

   "abcdefg".takeFrom("cd") tp // Prints: cdefg

Copy end

Copies String from the last position the specified x found

If no x found, dflt x is returned, or original if dflt is void.

   "abcd_abcd_abcd".takeFromLast("ab") tp // Prints: abcd

Boolean result conversion

Converts String to Boolean result

 "true".toBoolean_?? tp

 "abc".toBoolean_?? tp

 // Output
 Result(true)
 Result(failure=For input string: "abc")

Double result conversion

Converts String to Double result

 "123.45".toDouble_?? tp

 "abc".toDouble_?? tp

 // Output
 Result(123.45)
 Result(failure=For input string: "abc")

Int result conversion

Converts String to Int result

 "123".toInt_?? tp

 "abc".toInt_?? tp

 // Output
 Result(123)
 Result(failure=For input string: "abc")

Source of tokens

 Multi token tokenizetion

 Returns a Tuple including:

   - Separator preceding the token, empty for the first token
   - [[!.Range]] of the token in the text
   - String token

 ```
    val str: String = (1 <> 40).~.makeString()
    "Text to Tokenize:".tp.tp
    str.tp.tp
    ("Token", "Range", "String").tp
    str.replace("

", "").tokenized~(Stream("000","111","222","333","444")).tp

    // Output

    Text to Tokenize:

    12345678910111213141516171819202122232425262728293031323334353637383940

    (Token,Range,String)
    --- --------- -------------------
    ?   ?         ?
    --- --------- -------------------
        0 <>> 11  12345678910
    111 14 <>> 33 2131415161718192021
    222 36 <>> 55 3242526272829303132
    333 58 <>> 71 4353637383940
    --- --------- -------------------
 ```

Long result conversion

Converts String to Long result

  "123".toLong_?? tp

  "abc".toLong_?? tp

  // Output
  Result(123)
  Result(failure=For input string: "abc")

Trim both ends

Trims both ends of String from space Chars

Trim both ends

Trims both ends of String from Chars defined by let function

   "yyxxxxABCxxyyxx".trimBoth('x' <> 'z') tp                // Prints: ABC

   "yyxxxxABCxxyyxx".trimBoth(c => c == 'x' || c == 'y') tp // Prints: xxxxABCxx

Trim both ends

Trims end of String from Chars defined by let function

   "ABCxxyyxx".trimEnd('x' <> 'z') tp                // Prints: ABC

   "ABCxxyyxx".trimEnd(c => c == 'x' || c == 'y') tp // Prints: ABCxx

Trim end

Trims end of String from space Chars

Trim start

Trims start of String from Chars defined by let function

   "yyxxxxABC".trimBoth('x' <> 'z') tp                // Prints: ABC

   "yyxxxxABC".trimBoth(c => c == 'x' || c == 'y') tp // Prints: xxxxABC

Trim start

Trims start of String from space Chars

toUpperCase

Creates new String with all lower case Chars changed to upper case "aBc".upper tp // Prints: ABC