public final class VarString extends Object implements CharSequence, Appendable, Serializable
| Modifier and Type | Class and Description |
|---|---|
static interface |
VarString.Appendable
Implementors of this interface handle appending their specific string representation directly.
This is useful for preventing the instantiation and copying of potentially large temporary strings which can have unnecessary and devastatingly negative effects on performance. |
| Modifier and Type | Method and Description |
|---|---|
VarString |
add(boolean value) |
VarString |
add(byte value) |
VarString |
add(char c) |
VarString |
add(char[] chars) |
void |
add(char[] chars,
int offset,
int length) |
VarString |
add(Character c) |
VarString |
add(char c1,
char c2) |
VarString |
add(char c1,
char c2,
char c3) |
VarString |
add(CharSequence cs) |
VarString |
add(double value) |
<E> VarString |
add(E element,
BiConsumer<VarString,? super E> joiner) |
VarString |
add(float value) |
VarString |
add(int value) |
VarString |
add(long value) |
VarString |
add(Object o) |
VarString |
add(short value) |
VarString |
add(String s) |
VarString |
add(VarString vs) |
<E> VarString |
addAll(E[] elements,
BiConsumer<VarString,? super E> joiner) |
<E> VarString |
addAll(E[] elements,
int offset,
int length,
BiConsumer<VarString,? super E> joiner) |
<E> VarString |
addAll(Iterable<? extends E> elements,
BiConsumer<VarString,? super E> joiner) |
VarString |
addChars(char... chars) |
VarString |
addCharSequences(CharSequence... csqs) |
VarString |
addFalse() |
VarString |
addHexDec(byte... bytes) |
VarString |
addHexDec(byte value) |
VarString |
addMapped(boolean value,
String trueValue,
String falseValue) |
VarString |
addMapped(Boolean value,
String trueValue,
String falseValue) |
static void |
addNonNull(VarString vs,
Object object) |
VarString |
addNull() |
VarString |
addObjects(Object... objects) |
VarString |
addTrue() |
VarString |
append(char c) |
VarString |
append(CharSequence csq) |
VarString |
append(CharSequence csq,
int start,
int end) |
VarString |
append(VarString.Appendable appendable) |
VarString |
apply(Consumer<? super VarString> procedure) |
VarString |
blank() |
VarString |
blank(int amount) |
char |
charAt(int index) |
VarString |
clear()
Fills this instance's char storage completely with zeros and sets its size to 0.
|
static void |
commaSpace(VarString vs,
Object element) |
VarString |
consolidate() |
boolean |
contains(char c) |
boolean |
contains(char[] chars) |
boolean |
contains(String s) |
boolean |
contains(VarString vc) |
VarString |
copyTo(char[] target,
int targetOffset) |
VarString |
copyTo(int offset,
char[] target,
int targetOffset,
int length) |
int |
count(char c) |
int |
count(char[] chars) |
int |
count(String s) |
int |
count(VarString vc) |
VarString |
cr() |
VarString |
cr(int amount) |
VarString |
crlf() |
VarString |
deleteAt(int index) |
VarString |
deleteLast() |
VarString |
deleteLast(int n) |
byte[] |
encode()
Alias for
this.encodeBy(XChars.standardCharset()); for general purpose encoding, with the "standard"
being UTF-8 (XChars.utf8()), because any other charset is nonsense for a general case. |
byte[] |
encodeBy(Charset charset) |
boolean |
endsWith(char c) |
boolean |
endsWith(char[] chars) |
boolean |
endsWith(String string) |
void |
ensureCapacity(int minimumCapacity) |
void |
ensureFreeCapacity(int minimumFreeCapacity) |
boolean |
equalsAt(int index,
char[] chars,
int charsOffset,
int charsLength) |
char |
first() |
int |
indexOf(char c) |
int |
indexOf(char[] chars) |
int |
indexOf(char[] chars,
int offset) |
int |
indexOf(char c,
int offset) |
int |
indexOf(String s) |
int |
indexOf(String s,
int offset) |
int |
indexOf(VarString vc) |
int |
indexOf(VarString vc,
int offset) |
boolean |
isEmpty() |
void |
iterate(_charProcedure iterator) |
char |
last() |
int |
lastIndexOf(char c) |
int |
lastIndexOf(char c,
int offset) |
int |
length() |
VarString |
lf() |
VarString |
lf(int amount) |
VarString |
list(String separator,
boolean... listElements) |
VarString |
list(String separator,
byte... listElements) |
VarString |
list(String separator,
char... listElements) |
VarString |
list(String separator,
double... listElements) |
VarString |
list(String separator,
float... listElements) |
VarString |
list(String separator,
int... listElements) |
VarString |
list(String separator,
long... listElements) |
VarString |
list(String separator,
Object... listElements) |
VarString |
list(String separator,
short... listElements) |
VarString |
list(String separator,
String... listElements) |
VarString |
list(String separator,
VarString... listElements) |
VarString |
list(String separator,
VarString.Appendable... listElements) |
VarString |
list(String separator,
XGettingCollection<?> listElements) |
static VarString |
New() |
static VarString |
New(int initialMinimumCapacity) |
static VarString |
New(String s) |
VarString |
padLeft(String s,
int totalLength,
char paddingChar) |
VarString |
padRight(String s,
int totalLength,
char paddingChar) |
VarString |
repeat(int amount,
char c) |
VarString |
repeat(int amount,
char[] chars) |
VarString |
repeat(int amount,
String string) |
String |
replace(CharSequence target,
CharSequence replacement) |
VarString |
replaceAll(char sample,
char replacement) |
VarString |
replaceAll(char sample,
char replacement,
int offset) |
VarString |
replaceAll(char sample,
char replacement,
int offset,
int length) |
String |
replaceAll(String regex,
String replacement) |
VarString |
replaceFirst(char sample,
char replacement) |
VarString |
replaceFirst(char sample,
char replacement,
int offset) |
VarString |
replaceFirst(char sample,
char replacement,
int offset,
int length) |
String |
replaceFirst(String regex,
String replacement) |
VarString |
reset()
Simply resets this instance by setting its size to 0 while leaving the actual char storage untouched.
|
VarString |
reverse() |
VarString |
set(int index,
char c) |
VarString |
setChars(int index,
char... c) |
VarString |
setLast(char c) |
VarString |
shrinkTo(int n) |
String[] |
split(String regex) |
String[] |
split(String regex,
int limit) |
VarString |
subsequence(int beginIndex,
int endIndex) |
VarString |
subSequence(int start,
int end) |
String |
substring(int beginIndex,
int endIndex) |
VarString |
surrogateCharReverse()
Deprecated.
not implemented yet. Currently just calls
reverse(). |
VarString |
tab() |
VarString |
tab(int amount) |
char[] |
toArray() |
String |
toString() |
VarString |
trim() |
VarString |
truncateTo(int newLength) |
void |
validateIndex(int index) |
void |
validateRange(int offset,
int length) |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitchars, codePointspublic static final VarString New()
public static final VarString New(int initialMinimumCapacity)
public final void add(char[] chars,
int offset,
int length)
public final void validateIndex(int index)
public final void validateRange(int offset,
int length)
public final char last()
public final char first()
public final VarString add(char c)
public final VarString add(char c1, char c2)
public final VarString add(char c1, char c2, char c3)
public final VarString add(byte value)
public final VarString add(boolean value)
public final VarString add(short value)
public final VarString add(int value)
public final VarString add(float value)
public final VarString add(long value)
public final VarString add(double value)
public final VarString add(char[] chars)
public final VarString add(CharSequence cs)
public final VarString addHexDec(byte value)
public final VarString addHexDec(byte... bytes)
public final void ensureFreeCapacity(int minimumFreeCapacity)
public final void ensureCapacity(int minimumCapacity)
public final VarString addChars(char... chars)
public final VarString addCharSequences(CharSequence... csqs)
public final VarString addNull()
public final VarString addTrue()
public final VarString addFalse()
public final VarString append(VarString.Appendable appendable)
public final <E> VarString add(E element, BiConsumer<VarString,? super E> joiner)
public final <E> VarString addAll(E[] elements, BiConsumer<VarString,? super E> joiner)
public final <E> VarString addAll(E[] elements, int offset, int length, BiConsumer<VarString,? super E> joiner)
public final <E> VarString addAll(Iterable<? extends E> elements, BiConsumer<VarString,? super E> joiner)
public final VarString set(int index, char c)
public final VarString setChars(int index, char... c)
public final VarString setLast(char c)
public final VarString reverse()
@Deprecated public final VarString surrogateCharReverse()
reverse().public final int indexOf(char c)
public final int indexOf(char c,
int offset)
public final int indexOf(char[] chars)
public final int indexOf(char[] chars,
int offset)
public final int indexOf(String s)
public final int indexOf(String s, int offset)
public final int indexOf(VarString vc)
public final int indexOf(VarString vc, int offset)
public final boolean contains(char c)
public final boolean contains(char[] chars)
public final boolean contains(String s)
public final boolean contains(VarString vc)
public final int lastIndexOf(char c)
public final int lastIndexOf(char c,
int offset)
public final int count(char c)
public final int count(char[] chars)
public final int count(String s)
public final int count(VarString vc)
public final VarString deleteAt(int index)
public final VarString deleteLast()
public final VarString deleteLast(int n)
public final VarString shrinkTo(int n)
public final char[] toArray()
public final VarString copyTo(char[] target, int targetOffset)
public final VarString copyTo(int offset, char[] target, int targetOffset, int length)
public final boolean isEmpty()
public final VarString consolidate()
public final VarString trim()
public final VarString truncateTo(int newLength)
public final VarString subsequence(int beginIndex, int endIndex)
public final String substring(int beginIndex, int endIndex)
public final void iterate(_charProcedure iterator)
public final VarString list(String separator, XGettingCollection<?> listElements)
public final VarString list(String separator, VarString.Appendable... listElements)
public final VarString clear()
reset() for in-memory security reasons.public final VarString reset()
public final VarString blank()
public final VarString blank(int amount)
public final VarString tab()
public final VarString tab(int amount)
public final VarString cr()
public final VarString cr(int amount)
public final VarString lf()
public final VarString lf(int amount)
public final VarString crlf()
public final VarString repeat(int amount, char c)
public final VarString repeat(int amount, char[] chars)
public final boolean equalsAt(int index,
char[] chars,
int charsOffset,
int charsLength)
public final boolean endsWith(char c)
public final boolean endsWith(char[] chars)
public final boolean endsWith(String string)
public final VarString replaceFirst(char sample, char replacement)
public final VarString replaceFirst(char sample, char replacement, int offset)
public final VarString replaceFirst(char sample, char replacement, int offset, int length)
public final VarString replaceAll(char sample, char replacement)
public final VarString replaceAll(char sample, char replacement, int offset)
public final VarString replaceAll(char sample, char replacement, int offset, int length)
public final String replace(CharSequence target, CharSequence replacement)
public final byte[] encode()
this.encodeBy(XChars.standardCharset()); for general purpose encoding, with the "standard"
being UTF-8 (XChars.utf8()), because any other charset is nonsense for a general case.encodeBy(Charset)public final byte[] encodeBy(Charset charset)
public final char charAt(int index)
charAt in interface CharSequencepublic final int length()
length in interface CharSequencepublic final VarString subSequence(int start, int end)
subSequence in interface CharSequencepublic final VarString append(CharSequence csq)
append in interface Appendablepublic final VarString append(char c)
append in interface Appendablepublic final VarString append(CharSequence csq, int start, int end)
append in interface Appendablepublic final String toString()
toString in interface CharSequencetoString in class ObjectCopyright © 2022 MicroStream Software. All rights reserved.