UnprotectedStringBuffer (lecousin.net Java core framework 0.16.2 API)

java.lang.Object
- net.lecousin.framework.util.UnprotectedStringBuffer

All Implemented Interfaces:

CharSequence, IString

Direct Known Subclasses:

UnprotectedStringBufferLimited
```
public class UnprotectedStringBuffer
extends Object
implements IString
```
Array of UnprotectedString, allowing to add and remove characters without re-allocating a character array.

See Also:

UnprotectedString

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`UnprotectedStringBuffer.AbstractCS` Base class for CharacterStream implementations.
`protected class`	`UnprotectedStringBuffer.CS` CharacterStream implementation.
`protected class`	`UnprotectedStringBuffer.WCS` CharacterStream implementation.

Constructor Summary

Constructors
Constructor and Description
`UnprotectedStringBuffer()` Create a new empty string.
`UnprotectedStringBuffer(CharSequence s)` Create a string with the given one.
`UnprotectedStringBuffer(Collection<UnprotectedString> strings)` Create a string with the given ones.
`UnprotectedStringBuffer(IString s)` Create a string with the given one.
`UnprotectedStringBuffer(String s)` Create a string with the given one.
`UnprotectedStringBuffer(UnprotectedString string)` Create a string with the given one.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`UnprotectedStringBuffer`	`addFirst(char c)` Add the given string at the beginning.
`UnprotectedStringBuffer`	`addFirst(CharSequence s)` Add the given string at the beginning.
`UnprotectedStringBuffer`	`addFirst(UnprotectedString s)` Add the given string at the beginning.
`UnprotectedStringBuffer`	`append(char c)` Append a character.
`UnprotectedStringBuffer`	`append(char[] chars, int offset, int len)` Append characters.
`UnprotectedStringBuffer`	`append(CharSequence s)` Append characters.
`char[][]`	`asCharacters()` Convert into an array of character arrays.
`ICharacterStream.Readable.Buffered`	`asCharacterStream()` Create a readable CharacterStream from this string.
`CharBuffer[]`	`asCharBuffers()` Convert into an array of character buffers.
`ICharacterStream.Writable.Buffered`	`asWritableCharacterStream()` Create a writable CharacterStream from this string.
`char`	`charAt(int index)`
`Async<IOException>`	`encode(Charset charset, IO.Writable output, byte priority)` Encode this string with the given charset and write the result on the given writable IO.
`boolean`	`endsWith(CharSequence end)` Return true if this string ends with the given one.
`boolean`	`equals(UnprotectedStringBuffer s)` Compare this UnprotectedStringBuffer with another.
`int`	`fill(char[] chars, int start)` Fill the given character array with the content of this string.
`int`	`fillUsAsciiBytes(byte[] bytes, int start)` Same as with char but with bytes, all characters are directly converted into bytes without CharsetEncoder.
`int`	`getNbUsableUnprotectedStrings()` Return the number of UnprotectedString hold by this instance that can be used.
`UnprotectedString`	`getUnprotectedString(int index)` Return a specific UnprotectedString hold by this instance.
`int`	`indexOf(char c, int start)` Return the index of the first occurrence of the given character, starting at the given position, or -1 if not found.
`int`	`indexOf(CharSequence s, int start)` Return the index of the first occurrence of the given CharSequence, starting at the given position, or -1 if not found.
`boolean`	`isEmpty()` Return true if empty (length == 0).
`int`	`length()`
`UnprotectedStringBuffer`	`removeEndChars(int nb)` Remove the given number of characters at the end.
`UnprotectedStringBuffer`	`removeStartChars(int nb)` Remove the given number of characters at the beginning.
`UnprotectedStringBuffer`	`replace(char oldChar, char newChar)` Replace all occurrences of oldChar into newChar.
`UnprotectedStringBuffer`	`replace(char oldChar, CharSequence replaceValue)` Replace all occurrences of oldChar into replaceValue.
`UnprotectedStringBuffer`	`replace(CharSequence search, CharSequence replace)` Replace all occurrences of search into replace.
`UnprotectedStringBuffer`	`replace(CharSequence search, UnprotectedString replace)` Replace all occurrences of search into replace.
`UnprotectedStringBuffer`	`replace(char oldChar, UnprotectedString replaceValue)` Replace all occurrences of oldChar into replaceValue.
`void`	`replace(int start, int end, char c)` Remove characters from start to end (inclusive), and replace them by the given single character.
`void`	`replace(int start, int end, char[] chars)` Remove characters from start to end (inclusive), and replace them by the given characters.
`void`	`replace(int start, int end, UnprotectedString s)` Remove characters from start to end (inclusive), and replace them by the given string.
`UnprotectedStringBuffer`	`replace(int start, int end, UnprotectedStringBuffer s)` Remove characters from start to end (inclusive), and replace them by the given string.
`void`	`searchAndReplace(CharSequence start, CharSequence end, UnaryOperator<UnprotectedStringBuffer> valueProvider)` Search for a starting string and a ending string, and replace them including the content with new content.
`void`	`setCharAt(int index, char c)` Set a character.
`LinkedList<UnprotectedStringBuffer>`	`split(char sep)` Return a list of strings, by splitting the current string using the given character as separator.
`boolean`	`startsWith(CharSequence start)` Return true if this string starts with the given one.
`StringBuilder`	`subSequence(int start, int end)`
`UnprotectedStringBuffer`	`substring(int start)` Return a sub-string starting at the given position until the end.
`UnprotectedStringBuffer`	`substring(int start, int end)` Return a sub-string starting at the given start position (included) until the given end position (excluded).
`UnprotectedStringBuffer`	`toLowerCase()` Convert this string to lower case.
`String`	`toString()`
`UnprotectedStringBuffer`	`toUpperCase()` Convert this string to upper case.
`UnprotectedStringBuffer`	`trimBeginning()` Remove spaces characters at the beginning of this string.
`UnprotectedStringBuffer`	`trimEnd()` Remove spaces characters at the end of this string.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.lecousin.framework.util.IString
append, asString, encode, equals, fill, fillUsAsciiBytes, indexOf, indexOf, isStartOf, toUsAsciiBytes, trim

Methods inherited from interface java.lang.CharSequence
chars, codePoints

- Constructor Detail
  - UnprotectedStringBuffer
```
public UnprotectedStringBuffer()
```
    Create a new empty string.
  - UnprotectedStringBuffer
```
public UnprotectedStringBuffer(UnprotectedString string)
```
    Create a string with the given one.
  - UnprotectedStringBuffer
```
public UnprotectedStringBuffer(Collection<UnprotectedString> strings)
```
    Create a string with the given ones.
  - UnprotectedStringBuffer
```
public UnprotectedStringBuffer(String s)
```
    Create a string with the given one.
  - UnprotectedStringBuffer
```
public UnprotectedStringBuffer(CharSequence s)
```
    Create a string with the given one.
  - UnprotectedStringBuffer
```
public UnprotectedStringBuffer(IString s)
```
    Create a string with the given one.
- Method Detail
  - getNbUsableUnprotectedStrings
```
public int getNbUsableUnprotectedStrings()
```
    Return the number of UnprotectedString hold by this instance that can be used.
  - getUnprotectedString
```
public UnprotectedString getUnprotectedString(int index)
```
    Return a specific UnprotectedString hold by this instance.
  - length
```
public int length()
```
    Specified by:
    
    length in interface CharSequence
  - isEmpty
```
public boolean isEmpty()
```
    Description copied from interface: IString
    
    Return true if empty (length == 0).
    
    Specified by:
    
    isEmpty in interface IString
  - charAt
```
public char charAt(int index)
```
    Specified by:
    
    charAt in interface CharSequence
  - setCharAt
```
public void setCharAt(int index,
                      char c)
```
    Description copied from interface: IString
    
    Set a character.
    
    Specified by:
    
    setCharAt in interface IString
  - append
```
public UnprotectedStringBuffer append(char c)
```
    Description copied from interface: IString
    
    Append a character.
    
    Specified by:
    
    append in interface IString
  - append
```
public UnprotectedStringBuffer append(char[] chars,
                                      int offset,
                                      int len)
```
    Description copied from interface: IString
    
    Append characters.
    
    Specified by:
    
    append in interface IString
  - append
```
public UnprotectedStringBuffer append(CharSequence s)
```
    Description copied from interface: IString
    
    Append characters.
    
    Specified by:
    
    append in interface IString
  - addFirst
```
public UnprotectedStringBuffer addFirst(CharSequence s)
```
    Add the given string at the beginning.
  - addFirst
```
public UnprotectedStringBuffer addFirst(UnprotectedString s)
```
    Add the given string at the beginning.
  - addFirst
```
public UnprotectedStringBuffer addFirst(char c)
```
    Add the given string at the beginning.
  - indexOf
```
public int indexOf(char c,
                   int start)
```
    Description copied from interface: IString
    
    Return the index of the first occurrence of the given character, starting at the given position, or -1 if not found.
    
    Specified by:
    
    indexOf in interface IString
  - indexOf
```
public int indexOf(CharSequence s,
                   int start)
```
    Description copied from interface: IString
    
    Return the index of the first occurrence of the given CharSequence, starting at the given position, or -1 if not found.
    
    Specified by:
    
    indexOf in interface IString
  - subSequence
```
public StringBuilder subSequence(int start,
                                 int end)
```
    Specified by:
    
    subSequence in interface CharSequence
  - substring
```
public UnprotectedStringBuffer substring(int start)
```
    Description copied from interface: IString
    
    Return a sub-string starting at the given position until the end.
    
    Specified by:
    
    substring in interface IString
  - substring
```
public UnprotectedStringBuffer substring(int start,
                                         int end)
```
    Description copied from interface: IString
    
    Return a sub-string starting at the given start position (included) until the given end position (excluded).
    
    Specified by:
    
    substring in interface IString
  - equals
```
public boolean equals(UnprotectedStringBuffer s)
```
    Compare this UnprotectedStringBuffer with another.
  - fill
```
public int fill(char[] chars,
                int start)
```
    Description copied from interface: IString
    
    Fill the given character array with the content of this string.
    
    Specified by:
    
    fill in interface IString
  - fillUsAsciiBytes
```
public int fillUsAsciiBytes(byte[] bytes,
                            int start)
```
    Description copied from interface: IString
    
    Same as with char but with bytes, all characters are directly converted into bytes without CharsetEncoder.
    
    Specified by:
    
    fillUsAsciiBytes in interface IString
  - trimBeginning
```
public UnprotectedStringBuffer trimBeginning()
```
    Description copied from interface: IString
    
    Remove spaces characters at the beginning of this string.
    
    Specified by:
    
    trimBeginning in interface IString
  - trimEnd
```
public UnprotectedStringBuffer trimEnd()
```
    Description copied from interface: IString
    
    Remove spaces characters at the end of this string.
    
    Specified by:
    
    trimEnd in interface IString
  - removeStartChars
```
public UnprotectedStringBuffer removeStartChars(int nb)
```
    Description copied from interface: IString
    
    Remove the given number of characters at the beginning.
    
    Specified by:
    
    removeStartChars in interface IString
  - removeEndChars
```
public UnprotectedStringBuffer removeEndChars(int nb)
```
    Description copied from interface: IString
    
    Remove the given number of characters at the end.
    
    Specified by:
    
    removeEndChars in interface IString
  - split
```
public LinkedList<UnprotectedStringBuffer> split(char sep)
```
    Description copied from interface: IString
    
    Return a list of strings, by splitting the current string using the given character as separator.
    
    Specified by:
    
    split in interface IString
  - replace
```
public UnprotectedStringBuffer replace(CharSequence search,
                                       UnprotectedString replace)
```
    Replace all occurrences of search into replace.
  - replace
```
public UnprotectedStringBuffer replace(CharSequence search,
                                       CharSequence replace)
```
    Replace all occurrences of search into replace.
  - replace
```
public UnprotectedStringBuffer replace(char oldChar,
                                       char newChar)
```
    Description copied from interface: IString
    
    Replace all occurrences of oldChar into newChar.
    
    Specified by:
    
    replace in interface IString
  - replace
```
public UnprotectedStringBuffer replace(char oldChar,
                                       CharSequence replaceValue)
```
    Replace all occurrences of oldChar into replaceValue.
  - replace
```
public UnprotectedStringBuffer replace(char oldChar,
                                       UnprotectedString replaceValue)
```
    Replace all occurrences of oldChar into replaceValue.
  - replace
```
public void replace(int start,
                    int end,
                    char c)
```
    Remove characters from start to end (inclusive), and replace them by the given single character.
  - replace
```
public void replace(int start,
                    int end,
                    char[] chars)
```
    Remove characters from start to end (inclusive), and replace them by the given characters.
  - replace
```
public void replace(int start,
                    int end,
                    UnprotectedString s)
```
    Remove characters from start to end (inclusive), and replace them by the given string.
  - replace
```
public UnprotectedStringBuffer replace(int start,
                                       int end,
                                       UnprotectedStringBuffer s)
```
    Remove characters from start to end (inclusive), and replace them by the given string.
  - searchAndReplace
```
public void searchAndReplace(CharSequence start,
                             CharSequence end,
                             UnaryOperator<UnprotectedStringBuffer> valueProvider)
```
    Search for a starting string and a ending string, and replace them including the content with new content. This may be typically used to replace variables such as ${xxx} with their values.
  - toLowerCase
```
public UnprotectedStringBuffer toLowerCase()
```
    Description copied from interface: IString
    
    Convert this string to lower case.
    
    Specified by:
    
    toLowerCase in interface IString
  - toUpperCase
```
public UnprotectedStringBuffer toUpperCase()
```
    Description copied from interface: IString
    
    Convert this string to upper case.
    
    Specified by:
    
    toUpperCase in interface IString
  - startsWith
```
public boolean startsWith(CharSequence start)
```
    Description copied from interface: IString
    
    Return true if this string starts with the given one.
    
    Specified by:
    
    startsWith in interface IString
  - endsWith
```
public boolean endsWith(CharSequence end)
```
    Description copied from interface: IString
    
    Return true if this string ends with the given one.
    
    Specified by:
    
    endsWith in interface IString
  - toString
```
public String toString()
```
    Specified by:
    
    toString in interface CharSequence
    
    Overrides:
    
    toString in class Object
  - asCharacters
```
public char[][] asCharacters()
```
    Description copied from interface: IString
    
    Convert into an array of character arrays.
    
    Specified by:
    
    asCharacters in interface IString
  - asCharBuffers
```
public CharBuffer[] asCharBuffers()
```
    Description copied from interface: IString
    
    Convert into an array of character buffers.
    
    Specified by:
    
    asCharBuffers in interface IString
  - asCharacterStream
```
public ICharacterStream.Readable.Buffered asCharacterStream()
```
    Create a readable CharacterStream from this string.
  - asWritableCharacterStream
```
public ICharacterStream.Writable.Buffered asWritableCharacterStream()
```
    Create a writable CharacterStream from this string.
  - encode
```
public Async<IOException> encode(Charset charset,
                                 IO.Writable output,
                                 byte priority)
```
    Encode this string with the given charset and write the result on the given writable IO.

Class UnprotectedStringBuffer

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface net.lecousin.framework.util.IString

Methods inherited from interface java.lang.CharSequence

Constructor Detail

UnprotectedStringBuffer

UnprotectedStringBuffer

UnprotectedStringBuffer

UnprotectedStringBuffer

UnprotectedStringBuffer

UnprotectedStringBuffer

Method Detail

getNbUsableUnprotectedStrings

getUnprotectedString

length

isEmpty

charAt

setCharAt

append

append

append

addFirst

addFirst

addFirst

indexOf

indexOf

subSequence

substring

substring

equals

fill

fillUsAsciiBytes

trimBeginning

trimEnd

removeStartChars

removeEndChars

split

replace

replace

replace

replace

replace

replace

replace

replace

replace

searchAndReplace

toLowerCase

toUpperCase

startsWith

endsWith

toString

asCharacters

asCharBuffers

asCharacterStream

asWritableCharacterStream

encode