Inheritance diagram for javolution.text.TextBuilder:

Collaboration diagram for javolution.text.TextBuilder:

Public Member Functions
	TextBuilder ()

	TextBuilder (String str)

	TextBuilder (int capacity)

final int	length ()

final char	charAt (int index)

final void	getChars (int srcBegin, int srcEnd, char[] dst, int dstBegin)

final void	setCharAt (int index, char c)

final void	setLength (int newLength)

final void	setLength (int newLength, char fillChar)

final java.lang.CharSequence	subSequence (int start, int end)

final TextBuilder	append (char c)

final TextBuilder	append (Object obj)

final TextBuilder	append (CharSequence csq)

final TextBuilder	append (CharSequence csq, int start, int end)

final TextBuilder	append (String str)

final TextBuilder	append (String str, int start, int end)

final TextBuilder	append (Text txt)

final TextBuilder	append (Text txt, int start, int end)

final TextBuilder	append (char chars[])

final TextBuilder	append (char chars[], int offset, int length)

final TextBuilder	append (boolean b)

final TextBuilder	append (int i)

final TextBuilder	append (int i, int radix)

final TextBuilder	append (long l)

final TextBuilder	append (long l, int radix)

final TextBuilder	append (float f)

final TextBuilder	append (double d)

final TextBuilder	append (double d, int digits, boolean scientific, boolean showZero)

final TextBuilder	insert (int index, java.lang.CharSequence csq)

final TextBuilder	clear ()

final TextBuilder	delete (int start, int end)

final TextBuilder	reverse ()

final Text	toText ()

final String	toString ()

final CharArray	toCharArray ()

final int	hashCode ()

final boolean	equals (Object obj)

final boolean	contentEquals (java.lang.CharSequence csq)

Private Member Functions
void	appendPositive (int l1, int radix)

void	appendPositive (long l1, int radix)

void	appendFraction (long l, int digits, boolean showZero)

String	toLargeString ()

void	increaseCapacity ()

Private Attributes
char[]	_low = new char[C0]

char[][]	_high = new char[1][]

int	_length

int	_capacity = C0

Static Private Attributes
static final long	serialVersionUID = 0x600L

static final int	B0 = 5

static final int	C0 = 1 << B0

static final int	B1 = 10

static final int	C1 = 1 << B1

static final int	M1 = C1 - 1

static final char[]	DIGIT_TO_CHAR

static final long[]	POW10_LONG

Detailed Description

An Appendable text whose capacity expands gently without incurring expensive resize/copy operations ever.

This class is not intended for large documents manipulations which should be performed with the Text class directly (O(Log(n)) insertion and deletion capabilities).

The textual format of any appended object is retrieved from the current TextContext.

Author: Jean-Marie Dautelle

Version: 5.3, January 20, 2008

Definition at line 29 of file TextBuilder.java.

Constructor & Destructor Documentation

◆ TextBuilder() [1/3]

javolution.text.TextBuilder.TextBuilder ( )

Creates a text builder of small initial capacity.

Definition at line 57 of file TextBuilder.java.

                          {
         _high[0] = _low;
     }

References javolution.text.TextBuilder._high, and javolution.text.TextBuilder._low.

Referenced by javolution.text.TextBuilder.equals().

Here is the caller graph for this function:

◆ TextBuilder() [2/3]

javolution.text.TextBuilder.TextBuilder ( String str )

Creates a text builder holding the specified String (convenience method).

Parameters

str	the initial string content of this text builder.

Definition at line 67 of file TextBuilder.java.

                                    {
         this();
         append(str);
     }

References javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ TextBuilder() [3/3]

javolution.text.TextBuilder.TextBuilder ( int capacity )

Creates a text builder of specified initial capacity. Unless the text length exceeds the specified capacity, operations on this text builder will not allocate memory.

Parameters

capacity the initial capacity.

Definition at line 79 of file TextBuilder.java.

                                      {
         this();
         while (capacity > _capacity) {
             increaseCapacity();
         }
     }

References javolution.text.TextBuilder._capacity, and javolution.text.TextBuilder.increaseCapacity().

Here is the call graph for this function:

Member Function Documentation

◆ append() [1/18]

final TextBuilder javolution.text.TextBuilder.append ( boolean b )

Appends the textual representation of the specified boolean argument.

Parameters

b	the `boolean` to format.

Returns: this

See also: TypeFormat

Definition at line 396 of file TextBuilder.java.

                                                {
         return b ? append("true") : append("false");
     }

References javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ append() [2/18]

final TextBuilder javolution.text.TextBuilder.append ( char c )

Appends the specified character.

Parameters

c	the character to append.

Returns: this

Definition at line 202 of file TextBuilder.java.

                                             {
         if (_length >= _capacity)
             increaseCapacity();
         _high[_length >> B1][_length & M1] = c;
         _length++;
         return this;
     }

References javolution.text.TextBuilder._capacity, javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder.B1, javolution.text.TextBuilder.increaseCapacity(), and javolution.text.TextBuilder.M1.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.appendFraction(), javolution.text.TextBuilder.appendPositive(), javolution.text.TypeFormat.format(), javolution.io.Struct.UTF8String.get(), javolution.xml.internal.stream.XMLStreamWriterImpl.getRepairedPrefix(), javolution.context.internal.LogContextImpl.log(), javolution.test.Perfometer< T >.print(), javolution.xml.XMLFormat< T >.OutputElement.setAttribute(), javolution.text.TextBuilder.setLength(), javolution.text.TextBuilder.TextBuilder(), javolution.text.CharSet.toString(), javolution.io.Struct.toString(), javolution.xml.QName.valueOf(), javolution.text.Text.valueOf(), javolution.xml.internal.stream.XMLStreamWriterImpl.writeNewElement(), and javolution.xml.XMLReferenceResolver.writeReference().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ append() [3/18]

final TextBuilder javolution.text.TextBuilder.append ( char chars[] )

Appends the characters from the char array argument.

Parameters

chars the character array source.

Returns: this

Definition at line 353 of file TextBuilder.java.

                                                   {
         append(chars, 0, chars.length);
         return this;
     }

References javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ append() [4/18]

final TextBuilder javolution.text.TextBuilder.append	(	char	chars[],
		int	offset,
		int	length
	)

Appends the characters from a subarray of the char array argument.

Parameters

chars	the character array source.
offset	the index of the first character to append.
length	the number of character to append.

Returns: this

Exceptions

IndexOutOfBoundsException if (offset < 0) || (length < 0) || ((offset + length) > chars.length)

Definition at line 368 of file TextBuilder.java.

                                                                           {
         final int end = offset + length;
         if ((offset < 0) || (length < 0) || (end > chars.length))
             throw new IndexOutOfBoundsException();
         int newLength = _length + length;
         while (_capacity < newLength) {
             increaseCapacity();
         }
         for (int i = offset, j = _length; i < end;) {
             char[] dstChars = _high[j >> B1];
             int dstBegin = j & M1;
             int inc = MathLib.min(C1 - dstBegin, end - i);
             System.arraycopy(chars, i, dstChars, dstBegin, inc);
             i += inc;
             j += inc;
         }
         _length = newLength;
         return this;
     }

References javolution.text.TextBuilder._capacity, javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder.B1, javolution.text.TextBuilder.C1, javolution.text.TextBuilder.increaseCapacity(), javolution.text.TextBuilder.length(), javolution.text.TextBuilder.M1, and javolution.lang.MathLib.min().

Here is the call graph for this function:

◆ append() [5/18]

final TextBuilder javolution.text.TextBuilder.append ( CharSequence csq )

Appends the specified character sequence. If the specified character sequence is null this method is equivalent to append("null").

Parameters

csq	the character sequence to append or `null`.

Returns: this

Definition at line 230 of file TextBuilder.java.

                                                       {
         return (csq == null) ? append("null") : append(csq, 0, csq.length());
     }

References javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ append() [6/18]

final TextBuilder javolution.text.TextBuilder.append	(	CharSequence	csq,
		int	start,
		int	end
	)

Appends a subsequence of the specified character sequence. If the specified character sequence is null this method is equivalent to append("null").

Parameters

csq	the character sequence to append or `null`.
start	the index of the first character to append.
end	the index after the last character to append.

Returns: this

Exceptions

IndexOutOfBoundsException if (start < 0) || (end < 0) || (start > end) || (end > csq.length())

Definition at line 246 of file TextBuilder.java.

                      {
         if (csq == null)
             return append("null");
         if ((start < 0) || (end < 0) || (start > end) || (end > csq.length()))
             throw new IndexOutOfBoundsException();
         for (int i = start; i < end;) {
             append(csq.charAt(i++));
         }
         return this;
     }

References javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ append() [7/18]

final TextBuilder javolution.text.TextBuilder.append ( double d )

Appends the textual representation of the specified double; the number of digits is 17 or 16 when the 16 digits representation can be parsed back to the same double (mimic the standard library formatting).

Parameters

d	the `double` to format.

Returns: append(d, -1, (MathLib.abs(d) >= 1E7) || (MathLib.abs(d) < 0.001), false)

Definition at line 572 of file TextBuilder.java.

                                               {
         return append(d, -1, (MathLib.abs(d) >= 1E7)
                 || (MathLib.abs(d) < 0.001), false);
     }

References javolution.lang.MathLib.abs(), and javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ append() [8/18]

final TextBuilder javolution.text.TextBuilder.append	(	double	d,
		int	digits,
		boolean	scientific,
		boolean	showZero
	)

Appends the textual representation of the specified double according to the specified formatting arguments.

Parameters

d	the `double` value.
digits	the number of significative digits (excludes exponent) or `-1` to mimic the standard library (16 or 17 digits).
scientific	`true` to forces the use of the scientific notation (e.g. `1.23E3`); `false` otherwise.
showZero	`true` if trailing fractional zeros are represented; `false` otherwise.

Returns: TypeFormat.format(d, digits, scientific, showZero, this)

Exceptions

IllegalArgumentException if (digits > 19))

Definition at line 592 of file TextBuilder.java.

                               {
         if (digits > 19)
             throw new IllegalArgumentException("digits: " + digits);
         if (d != d) // NaN
             return append("NaN");
         if (d == Double.POSITIVE_INFINITY)
             return append("Infinity");
         if (d == Double.NEGATIVE_INFINITY)
             return append("-Infinity");
         if (d == 0.0) { // Zero.
             if (digits < 0)
                 return append("0.0");
             append('0');
             if (showZero) {
                 append('.');
                 for (int j = 1; j < digits; j++) {
                     append('0');
                 }
             }
             return this;
         }
         if (d < 0) { // Work with positive number.
             d = -d;
             append('-');
         }
  
         // Find the exponent e such as: value == x.xxx * 10^e
         int e = MathLib.floorLog10(d);
  
         long m;
         if (digits < 0) { // Use 16 or 17 digits.
             // Try 17 digits.
             long m17 = MathLib.toLongPow10(d, (17 - 1) - e);
             // Check if we can use 16 digits.
             long m16 = m17 / 10;
             double dd = MathLib.toDoublePow10(m16, e - 16 + 1);
             if (dd == d) { // 16 digits is enough.
                 digits = 16;
                 m = m16;
             } else { // We cannot remove the last digit.
                 digits = 17;
                 m = m17;
             }
         } else
             // Use the specified number of digits.
             m = MathLib.toLongPow10(d, (digits - 1) - e);
  
         // Formats.
         if (scientific || (e >= digits)) {
             // Scientific notation has to be used ("x.xxxEyy").
             long pow10 = POW10_LONG[digits - 1];
             int k = (int) (m / pow10); // Single digit.
             append((char) ('0' + k));
             m = m - pow10 * k;
             appendFraction(m, digits - 1, showZero);
             append('E');
             append(e);
         } else { // Dot within the string ("xxxx.xxxxx").
             int exp = digits - e - 1;
             if (exp < POW10_LONG.length) {
                 long pow10 = POW10_LONG[exp];
                 long l = m / pow10;
                 append(l);
                 m = m - pow10 * l;
             } else
                 append('0'); // Result of the division by a power of 10 larger than any long.
             appendFraction(m, exp, showZero);
         }
         return this;
     }

References javolution.text.TextBuilder.append(), javolution.text.TextBuilder.appendFraction(), javolution.lang.MathLib.floorLog10(), javolution.text.TextBuilder.POW10_LONG, javolution.lang.MathLib.toDoublePow10(), and javolution.lang.MathLib.toLongPow10().

Here is the call graph for this function:

◆ append() [9/18]

final TextBuilder javolution.text.TextBuilder.append ( float f )

Appends the textual representation of the specified float.

Parameters

f	the `float` to format.

Returns: append(f, 10, (abs(f) >= 1E7) || (abs(f) < 0.001), false)

Definition at line 557 of file TextBuilder.java.

                                              {
         return append(f, 10, (MathLib.abs(f) >= 1E7)
                 || (MathLib.abs(f) < 0.001), false);
     }

References javolution.lang.MathLib.abs(), and javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ append() [10/18]

final TextBuilder javolution.text.TextBuilder.append ( int i )

Appends the decimal representation of the specified int argument.

Parameters

i	the `int` to format.

Returns: this

Definition at line 407 of file TextBuilder.java.

                                            {
         if (i <= 0) {
             if (i == 0)
                 return append("0");
             if (i == Integer.MIN_VALUE) // Negation would overflow.
                 return append("-2147483648");
             append('-');
             i = -i;
         }
         int digits = MathLib.digitLength(i);
         if (_capacity < _length + digits)
             increaseCapacity();
         _length += digits;
         for (int index = _length - 1;; index--) {
             int j = i / 10;
             _high[index >> B1][index & M1] = (char) ('0' + i - (j * 10));
             if (j == 0)
                 return this;
             i = j;
         }
     }

References javolution.text.TextBuilder._capacity, javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder.append(), javolution.text.TextBuilder.B1, javolution.lang.MathLib.digitLength(), javolution.text.TextBuilder.increaseCapacity(), and javolution.text.TextBuilder.M1.

Here is the call graph for this function:

◆ append() [11/18]

final TextBuilder javolution.text.TextBuilder.append	(	int	i,
		int	radix
	)

Appends the radix representation of the specified int argument.

Parameters

i	the `int` to format.
radix	the radix (e.g. `16` for hexadecimal).

Returns: this

Definition at line 437 of file TextBuilder.java.

                                                       {
         if (radix == 10)
             return append(i); // Faster.
         if (radix < 2 || radix > 36)
             throw new IllegalArgumentException("radix: " + radix);
         if (i < 0) {
             append('-');
             if (i == Integer.MIN_VALUE) { // Negative would overflow.
                 appendPositive(-(i / radix), radix);
                 return (TextBuilder) append(DIGIT_TO_CHAR[-(i % radix)]);
             }
             i = -i;
         }
         appendPositive(i, radix);
         return this;
     }

References javolution.text.TextBuilder.append(), javolution.text.TextBuilder.appendPositive(), and javolution.text.TextBuilder.DIGIT_TO_CHAR.

Here is the call graph for this function:

◆ append() [12/18]

final TextBuilder javolution.text.TextBuilder.append ( long l )

Appends the decimal representation of the specified long argument.

Parameters

l	the `long` to format.

Returns: this

Definition at line 487 of file TextBuilder.java.

                                             {
         if (l <= 0) {
             if (l == 0)
                 return append("0");
             if (l == Long.MIN_VALUE) // Negation would overflow.
                 return append("-9223372036854775808");
             append('-');
             l = -l;
         }
         if (l <= Integer.MAX_VALUE)
             return append((int) l);
         append(l / 1000000000);
         int i = (int) (l % 1000000000);
         int digits = MathLib.digitLength(i);
         append("000000000", 0, 9 - digits);
         return append(i);
     }

References javolution.text.TextBuilder.append(), and javolution.lang.MathLib.digitLength().

Here is the call graph for this function:

◆ append() [13/18]

final TextBuilder javolution.text.TextBuilder.append	(	long	l,
		int	radix
	)

Appends the radix representation of the specified long argument.

Parameters

l	the `long` to format.
radix	the radix (e.g. `16` for hexadecimal).

Returns: this

Definition at line 513 of file TextBuilder.java.

                                                        {
         if (radix == 10)
             return append(l); // Faster.
         if (radix < 2 || radix > 36)
             throw new IllegalArgumentException("radix: " + radix);
         if (l < 0) {
             append('-');
             if (l == Long.MIN_VALUE) { // Negative would overflow.
                 appendPositive(-(l / radix), radix);
                 return (TextBuilder) append(DIGIT_TO_CHAR[(int) -(l % radix)]);
             }
             l = -l;
         }
         appendPositive(l, radix);
         return this;
     }

References javolution.text.TextBuilder.append(), javolution.text.TextBuilder.appendPositive(), and javolution.text.TextBuilder.DIGIT_TO_CHAR.

Here is the call graph for this function:

◆ append() [14/18]

final TextBuilder javolution.text.TextBuilder.append ( Object obj )

Appends the textual representation of the specified object. This method is equivalent to

TextContext.getFormat(obj.getClass()).format(obj, this)

Definition at line 215 of file TextBuilder.java.

                                                 {
         if (obj == null) return append("null");
         TextFormat<Object> textFormat = TextContext.getFormat(obj.getClass());
         if (textFormat == null) return append(obj.toString());
         return textFormat.format(obj, this);
     }

References javolution.text.TextBuilder.append(), javolution.text.TextFormat< T >.format(), and javolution.text.TextContext.getFormat().

Here is the call graph for this function:

◆ append() [15/18]

final TextBuilder javolution.text.TextBuilder.append ( String str )

Appends the specified string to this text builder. If the specified string is null this method is equivalent to append("null").

Parameters

str	the string to append or `null`.

Returns: this

Definition at line 266 of file TextBuilder.java.

                                                 {
         return (str == null) ? append("null") : append(str, 0, str.length());
     }

References javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ append() [16/18]

final TextBuilder javolution.text.TextBuilder.append	(	String	str,
		int	start,
		int	end
	)

Appends a subsequence of the specified string. If the specified character sequence is null this method is equivalent to append("null").

Parameters

str	the string to append or `null`.
start	the index of the first character to append.
end	the index after the last character to append.

Returns: this

Exceptions

IndexOutOfBoundsException if (start < 0) || (end < 0) || (start > end) || (end > str.length())

Definition at line 282 of file TextBuilder.java.

                                                                     {
         if (str == null)
             return append("null");
         if ((start < 0) || (end < 0) || (start > end) || (end > str.length()))
             throw new IndexOutOfBoundsException("start: " + start + ", end: "
                     + end + ", str.length(): " + str.length());
         int newLength = _length + end - start;
         while (_capacity < newLength) {
             increaseCapacity();
         }
         for (int i = start, j = _length; i < end;) {
             char[] chars = _high[j >> B1];
             int dstBegin = j & M1;
             int inc = MathLib.min(C1 - dstBegin, end - i);
             str.getChars(i, (i += inc), chars, dstBegin);
             j += inc;
         }
         _length = newLength;
         return this;
     }

References javolution.text.TextBuilder._capacity, javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder.append(), javolution.text.TextBuilder.B1, javolution.text.TextBuilder.C1, javolution.text.TextBuilder.increaseCapacity(), javolution.text.TextBuilder.M1, and javolution.lang.MathLib.min().

Here is the call graph for this function:

◆ append() [17/18]

final TextBuilder javolution.text.TextBuilder.append ( Text txt )

Appends the specified text to this text builder. If the specified text is null this method is equivalent to append("null").

Parameters

txt	the text to append or `null`.

Returns: this

Definition at line 311 of file TextBuilder.java.

                                               {
         return (txt == null) ? append("null") : append(txt, 0, txt.length());
     }

References javolution.text.TextBuilder.append(), and javolution.text.Text.length().

Here is the call graph for this function:

◆ append() [18/18]

final TextBuilder javolution.text.TextBuilder.append	(	Text	txt,
		int	start,
		int	end
	)

Appends a subsequence of the specified text. If the specified character sequence is null this method is equivalent to append("null").

Parameters

txt	the text to append or `null`.
start	the index of the first character to append.
end	the index after the last character to append.

Returns: this

Exceptions

IndexOutOfBoundsException if (start < 0) || (end < 0) || (start > end) || (end > txt.length())

Definition at line 327 of file TextBuilder.java.

                                                                   {
         if (txt == null)
             return append("null");
         if ((start < 0) || (end < 0) || (start > end) || (end > txt.length()))
             throw new IndexOutOfBoundsException();
         int newLength = _length + end - start;
         while (_capacity < newLength) {
             increaseCapacity();
         }
         for (int i = start, j = _length; i < end;) {
             char[] chars = _high[j >> B1];
             int dstBegin = j & M1;
             int inc = MathLib.min(C1 - dstBegin, end - i);
             txt.getChars(i, (i += inc), chars, dstBegin);
             j += inc;
         }
         _length = newLength;
         return this;
     }

References javolution.text.TextBuilder._capacity, javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder.append(), javolution.text.TextBuilder.B1, javolution.text.TextBuilder.C1, javolution.text.Text.getChars(), javolution.text.TextBuilder.increaseCapacity(), javolution.text.Text.length(), javolution.text.TextBuilder.M1, and javolution.lang.MathLib.min().

Here is the call graph for this function:

◆ appendFraction()

void javolution.text.TextBuilder.appendFraction	(	long	l,
		int	digits,
		boolean	showZero
	)

private

Definition at line 664 of file TextBuilder.java.

                                                                       {
         append('.');
         if (l == 0)
             if (showZero)
                 for (int i = 0; i < digits; i++) {
                     append('0');
                 }
             else
                 append('0');
         else { // l is different from zero.
             int length = MathLib.digitLength(l);
             for (int j = length; j < digits; j++) {
                 append('0'); // Add leading zeros.
             }
             if (!showZero)
                 while (l % 10 == 0) {
                     l /= 10; // Remove trailing zeros.
                 }
             append(l);
         }
     }

References javolution.text.TextBuilder.append(), javolution.lang.MathLib.digitLength(), and javolution.text.TextBuilder.length().

Referenced by javolution.text.TextBuilder.append().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ appendPositive() [1/2]

void javolution.text.TextBuilder.appendPositive	(	int	l1,
		int	radix
	)

private

Definition at line 454 of file TextBuilder.java.

                                                    {
         if (l1 >= radix) {
             int l2 = l1 / radix;
             // appendPositive(l2, radix);
             if (l2 >= radix) {
                 int l3 = l2 / radix;
                 // appendPositive(l3, radix);
                 if (l3 >= radix) {
                     int l4 = l3 / radix;
                     appendPositive(l4, radix);
                     append(DIGIT_TO_CHAR[l3 - (l4 * radix)]);
                 } else
                     append(DIGIT_TO_CHAR[l3]);
                 append(DIGIT_TO_CHAR[l2 - (l3 * radix)]);
             } else
                 append(DIGIT_TO_CHAR[l2]);
             append(DIGIT_TO_CHAR[l1 - (l2 * radix)]);
         } else
             append(DIGIT_TO_CHAR[l1]);
     }

References javolution.text.TextBuilder.append(), and javolution.text.TextBuilder.DIGIT_TO_CHAR.

Referenced by javolution.text.TextBuilder.append(), and javolution.text.TextBuilder.appendPositive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ appendPositive() [2/2]

void javolution.text.TextBuilder.appendPositive	(	long	l1,
		int	radix
	)

private

Definition at line 530 of file TextBuilder.java.

                                                     {
         if (l1 >= radix) {
             long l2 = l1 / radix;
             // appendPositive(l2, radix);
             if (l2 >= radix) {
                 long l3 = l2 / radix;
                 // appendPositive(l3, radix);
                 if (l3 >= radix) {
                     long l4 = l3 / radix;
                     appendPositive(l4, radix);
                     append(DIGIT_TO_CHAR[(int) (l3 - (l4 * radix))]);
                 } else
                     append(DIGIT_TO_CHAR[(int) l3]);
                 append(DIGIT_TO_CHAR[(int) (l2 - (l3 * radix))]);
             } else
                 append(DIGIT_TO_CHAR[(int) l2]);
             append(DIGIT_TO_CHAR[(int) (l1 - (l2 * radix))]);
         } else
             append(DIGIT_TO_CHAR[(int) l1]);
     }

References javolution.text.TextBuilder.append(), javolution.text.TextBuilder.appendPositive(), and javolution.text.TextBuilder.DIGIT_TO_CHAR.

Here is the call graph for this function:

◆ charAt()

final char javolution.text.TextBuilder.charAt ( int index )

Returns the character at the specified index.

Parameters

index the index of the character.

Returns: the character at the specified index.

Exceptions

IndexOutOfBoundsException if (index < 0) || (index >= this.length()).

Definition at line 103 of file TextBuilder.java.

                                         {
         if (index >= _length)
             throw new IndexOutOfBoundsException();
         return index < C1 ? _low[index] : _high[index >> B1][index & M1];
     }

References javolution.text.TextBuilder._length, javolution.text.TextBuilder.B1, and javolution.text.TextBuilder.M1.

Referenced by javolution.text.TextBuilder.delete(), javolution.text.TextBuilder.equals(), javolution.text.TextBuilder.hashCode(), javolution.text.TextBuilder.insert(), and javolution.text.TextBuilder.reverse().

Here is the caller graph for this function:

◆ clear()

final TextBuilder javolution.text.TextBuilder.clear ( )

Removes all the characters of this text builder (equivalent to this.delete(start, this.length())).

Returns: this.delete(0, this.length())

Definition at line 725 of file TextBuilder.java.

                                      {
         _length = 0;
         return this;
     }

References javolution.text.TextBuilder._length.

Referenced by javolution.xml.internal.stream.XMLStreamWriterImpl.getRepairedPrefix(), javolution.xml.ws.WebServiceClient.invoke(), javolution.xml.XMLFormat< T >.OutputElement.setAttribute(), javolution.xml.internal.stream.XMLStreamWriterImpl.writeNewElement(), and javolution.xml.XMLReferenceResolver.writeReference().

Here is the caller graph for this function:

◆ contentEquals()

final boolean javolution.text.TextBuilder.contentEquals ( java.lang.CharSequence csq )

Indicates if this text builder has the same character content as the specified character sequence.

Parameters

csq	the character sequence to compare with.

Returns: true if the specified character sequence has the same character content as this text; false otherwise.

Definition at line 856 of file TextBuilder.java.

                                                                    {
         if (csq.length() != _length)
             return false;
         for (int i = 0; i < _length;) {
             char c = _high[i >> B1][i & M1];
             if (csq.charAt(i++) != c)
                 return false;
         }
         return true;
     }

References javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder.B1, and javolution.text.TextBuilder.M1.

◆ delete()

final TextBuilder javolution.text.TextBuilder.delete	(	int	start,
		int	end
	)

Removes the characters between the specified indices.

Parameters

start	the beginning index, inclusive.
end	the ending index, exclusive.

Returns: this

Exceptions

IndexOutOfBoundsException if (start < 0) || (end < 0) || (start > end) || (end > this.length())

Definition at line 739 of file TextBuilder.java.

                                                         {
         if ((start < 0) || (end < 0) || (start > end) || (end > this.length()))
             throw new IndexOutOfBoundsException();
         for (int i = end, j = start; i < _length;) {
             this.setCharAt(j++, this.charAt(i++));
         }
         _length -= end - start;
         return this;
     }

References javolution.text.TextBuilder._length, javolution.text.TextBuilder.charAt(), javolution.text.TextBuilder.length(), and javolution.text.TextBuilder.setCharAt().

Here is the call graph for this function:

◆ equals()

final boolean javolution.text.TextBuilder.equals ( Object obj )

Compares this text builder against the specified object for equality. Returns true if the specified object is a text builder having the same character content.

Parameters

obj	the object to compare with or `null`.

Returns: true if that is a text builder with the same character content as this text; false otherwise.

Definition at line 833 of file TextBuilder.java.

                                             {
         if (this == obj)
             return true;
         if (!(obj instanceof TextBuilder))
             return false;
         TextBuilder that = (TextBuilder) obj;
         if (this._length != that._length)
             return false;
         for (int i = 0; i < _length;) {
             if (this.charAt(i) != that.charAt(i++))
                 return false;
         }
         return true;
     }

References javolution.text.TextBuilder._length, javolution.text.TextBuilder.charAt(), and javolution.text.TextBuilder.TextBuilder().

Here is the call graph for this function:

◆ getChars()

final void javolution.text.TextBuilder.getChars	(	int	srcBegin,
		int	srcEnd,
		char[]	dst,
		int	dstBegin
	)

Copies the character from this text builder into the destination character array.

Parameters

srcBegin	this text start index.
srcEnd	this text end index (not included).
dst	the destination array to copy the data into.
dstBegin	the offset into the destination array.

Exceptions

IndexOutOfBoundsException if (srcBegin < 0) || (dstBegin < 0) || (srcBegin > srcEnd) || (srcEnd > this.length()) || ((dstBegin + srcEnd - srcBegin) > dst.length)

Definition at line 121 of file TextBuilder.java.

                           {
         if ((srcBegin < 0) || (srcBegin > srcEnd) || (srcEnd > this._length))
             throw new IndexOutOfBoundsException();
         for (int i = srcBegin, j = dstBegin; i < srcEnd;) {
             char[] chars0 = _high[i >> B1];
             int i0 = i & M1;
             int length = MathLib.min(C1 - i0, srcEnd - i);
             System.arraycopy(chars0, i0, dst, j, length);
             i += length;
             j += length;
         }
     }

References javolution.text.TextBuilder._high, javolution.text.TextBuilder.B1, javolution.text.TextBuilder.C1, javolution.text.TextBuilder.length(), javolution.text.TextBuilder.M1, and javolution.lang.MathLib.min().

Referenced by javolution.io.CharSequenceReader.read(), javolution.text.TextBuilder.toCharArray(), javolution.text.TextBuilder.toLargeString(), and javolution.text.Text.valueOf().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hashCode()

final int javolution.text.TextBuilder.hashCode ( )

Returns the hash code for this text builder.

Returns: the hash code value.

Definition at line 815 of file TextBuilder.java.

                                 {
         int h = 0;
         for (int i = 0; i < _length;) {
             h = 31 * h + charAt(i++);
         }
         return h;
     }

References javolution.text.TextBuilder._length, and javolution.text.TextBuilder.charAt().

Here is the call graph for this function:

◆ increaseCapacity()

void javolution.text.TextBuilder.increaseCapacity ( )

private

Increases this text builder capacity.

Definition at line 870 of file TextBuilder.java.

                                     {
         if (_capacity < C1) { // For small capacity, resize.
             _capacity <<= 1;
             char[] tmp = new char[_capacity];
             System.arraycopy(_low, 0, tmp, 0, _length);
             _low = tmp;
             _high[0] = tmp;
         } else { // Add a new low block of 1024 elements.
             int j = _capacity >> B1;
             if (j >= _high.length) { // Resizes _high.
                 char[][] tmp = new char[_high.length * 2][];
                 System.arraycopy(_high, 0, tmp, 0, _high.length);
                 _high = tmp;
             }
             _high[j] = new char[C1];
             _capacity += C1;
         }
     }

References javolution.text.TextBuilder._capacity, javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder._low, javolution.text.TextBuilder.B1, and javolution.text.TextBuilder.C1.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.insert(), and javolution.text.TextBuilder.TextBuilder().

Here is the caller graph for this function:

◆ insert()

final TextBuilder javolution.text.TextBuilder.insert	(	int	index,
		java.lang.CharSequence	csq
	)

Inserts the specified character sequence at the specified location.

Parameters

index	the insertion position.
csq	the character sequence being inserted.

Returns: this

Exceptions

IndexOutOfBoundsException if (index < 0) || (index > this.length())

Definition at line 701 of file TextBuilder.java.

                                                                            {
         if ((index < 0) || (index > _length))
             throw new IndexOutOfBoundsException("index: " + index);
         final int shift = csq.length();
         int newLength = _length + shift;
         while (newLength >= _capacity) {
             increaseCapacity();
         }
         _length = newLength;
         for (int i = _length - shift; --i >= index;) {
             this.setCharAt(i + shift, this.charAt(i));
         }
         for (int i = csq.length(); --i >= 0;) {
             this.setCharAt(index + i, csq.charAt(i));
         }
         return this;
     }

References javolution.text.TextBuilder._capacity, javolution.text.TextBuilder._length, javolution.text.TextBuilder.charAt(), javolution.text.TextBuilder.increaseCapacity(), and javolution.text.TextBuilder.setCharAt().

Here is the call graph for this function:

◆ length()

final int javolution.text.TextBuilder.length ( )

Returns the length (character count) of this text builder.

Returns: the number of characters (16-bits Unicode).

Definition at line 91 of file TextBuilder.java.

                               {
         return _length;
     }

References javolution.text.TextBuilder._length.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.appendFraction(), javolution.text.TextBuilder.delete(), javolution.text.TextBuilder.getChars(), javolution.xml.ws.WebServiceClient.invoke(), javolution.test.Perfometer< T >.print(), javolution.xml.internal.stream.XMLStreamWriterImpl.resizeElemStack(), javolution.text.CharSet.toString(), javolution.xml.internal.stream.XMLStreamWriterImpl.writeNewElement(), and javolution.xml.internal.stream.XMLStreamWriterImpl.XMLStreamWriterImpl().

Here is the caller graph for this function:

◆ reverse()

final TextBuilder javolution.text.TextBuilder.reverse ( )

Reverses this character sequence.

Returns: this

Definition at line 754 of file TextBuilder.java.

                                        {
         final int n = _length - 1;
         for (int j = (n - 1) >> 1; j >= 0;) {
             char c = charAt(j);
             setCharAt(j, charAt(n - j));
             setCharAt(n - j--, c);
         }
         return this;
     }

References javolution.text.TextBuilder._length, javolution.text.TextBuilder.charAt(), and javolution.text.TextBuilder.setCharAt().

Here is the call graph for this function:

◆ setCharAt()

final void javolution.text.TextBuilder.setCharAt	(	int	index,
		char	c
	)

Sets the character at the specified position.

Parameters

index	the index of the character to modify.
c	the new character.

Exceptions

IndexOutOfBoundsException if (index < 0) || (index >= this.length())

Definition at line 143 of file TextBuilder.java.

                                                    {
         if ((index < 0) || (index >= _length))
             throw new IndexOutOfBoundsException();
         _high[index >> B1][index & M1] = c;
     }

References javolution.text.TextBuilder._high, javolution.text.TextBuilder._length, javolution.text.TextBuilder.B1, and javolution.text.TextBuilder.M1.

Referenced by javolution.text.TextBuilder.delete(), javolution.text.TextBuilder.insert(), and javolution.text.TextBuilder.reverse().

Here is the caller graph for this function:

◆ setLength() [1/2]

final void javolution.text.TextBuilder.setLength ( int newLength )

Convenience method equivalent to setLength(newLength, '').

Parameters

newLength the new length of this builder.

Exceptions

IndexOutOfBoundsException if (newLength < 0)

Definition at line 156 of file TextBuilder.java.

                                                {
         setLength(newLength, '\u0000');
     }

◆ setLength() [2/2]

final void javolution.text.TextBuilder.setLength	(	int	newLength,
		char	fillChar
	)

Sets the length of this character builder. If the length is greater than the current length; the specified character is inserted.

Parameters

newLength	the new length of this builder.
fillChar	the character to be appended if required.

Exceptions

IndexOutOfBoundsException if (newLength < 0)

Definition at line 169 of file TextBuilder.java.

                                                               {
         if (newLength < 0)
             throw new IndexOutOfBoundsException();
         if (newLength <= _length)
             _length = newLength;
         else
             for (int i = _length; i++ < newLength;) {
                 append(fillChar);
             }
     }

References javolution.text.TextBuilder._length, and javolution.text.TextBuilder.append().

Here is the call graph for this function:

◆ subSequence()

final java.lang.CharSequence javolution.text.TextBuilder.subSequence	(	int	start,
		int	end
	)

Returns a java.lang.CharSequence corresponding to the character sequence between the specified indexes.

Parameters

start	the index of the first character inclusive.
end	the index of the last character exclusive.

Returns: a character sequence.

Exceptions

IndexOutOfBoundsException if (start < 0) || (end < 0) || (start > end) || (end > this.length())

Definition at line 190 of file TextBuilder.java.

                                                                         {
         if ((start < 0) || (end < 0) || (start > end) || (end > _length))
             throw new IndexOutOfBoundsException();
         return Text.valueOf(this, start, end);
     }

References javolution.text.TextBuilder._length, and javolution.text.Text.valueOf().

Here is the call graph for this function:

◆ toCharArray()

final CharArray javolution.text.TextBuilder.toCharArray ( )

Returns the CharArray representation of this TextBuilder.

Returns: the corresponding CharArray instance.

Definition at line 796 of file TextBuilder.java.

                                          {
         CharArray cArray = new CharArray();
         char[] data;
         if (_length < C1) {
             data = _low;
         } else {
             data = new char[_length];
             this.getChars(0, _length, data, 0);
         }
         cArray.setArray(data, 0, _length);
         return cArray;
     }

References javolution.text.TextBuilder._length, javolution.text.TextBuilder._low, javolution.text.TextBuilder.C1, javolution.text.TextBuilder.getChars(), and javolution.text.CharArray.setArray().

Here is the call graph for this function:

◆ toLargeString()

String javolution.text.TextBuilder.toLargeString ( )

private

Definition at line 784 of file TextBuilder.java.

                                    {
         char[] data = new char[_length];
         this.getChars(0, _length, data, 0);
         return new String(data, 0, _length);
     }

References javolution.text.TextBuilder._length, and javolution.text.TextBuilder.getChars().

Referenced by javolution.text.TextBuilder.toString().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toString()

final String javolution.text.TextBuilder.toString ( )

Returns the String representation of this TextBuilder.

Returns: the java.lang.String for this text builder.

Definition at line 780 of file TextBuilder.java.

                                    {
         return (_length < C1) ? new String(_low, 0, _length) : toLargeString();
     }

References javolution.text.TextBuilder._length, javolution.text.TextBuilder._low, javolution.text.TextBuilder.C1, and javolution.text.TextBuilder.toLargeString().

Referenced by javolution.io.Struct.UTF8String.get(), javolution.context.internal.LogContextImpl.log(), javolution.text.CharSet.toString(), and javolution.io.Struct.toString().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toText()

final Text javolution.text.TextBuilder.toText ( )

Returns the Text corresponding to this TextBuilder.

Returns: the corresponding Text instance.

Definition at line 769 of file TextBuilder.java.

                                {
         return Text.valueOf(this, 0, _length);
     }

References javolution.text.TextBuilder._length, and javolution.text.Text.valueOf().

Referenced by javolution.text.Text.valueOf().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ _capacity

int javolution.text.TextBuilder._capacity = C0

private

Holds current capacity.

Definition at line 52 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.increaseCapacity(), javolution.text.TextBuilder.insert(), and javolution.text.TextBuilder.TextBuilder().

◆ _high

char [][] javolution.text.TextBuilder._high = new char[1][]

private

Definition at line 42 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.contentEquals(), javolution.text.TextBuilder.getChars(), javolution.text.TextBuilder.increaseCapacity(), javolution.text.TextBuilder.setCharAt(), and javolution.text.TextBuilder.TextBuilder().

◆ _length

int javolution.text.TextBuilder._length

private

Holds the current length.

Definition at line 47 of file TextBuilder.java.

◆ _low

char [] javolution.text.TextBuilder._low = new char[C0]

private

Definition at line 40 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.increaseCapacity(), javolution.text.TextBuilder.TextBuilder(), javolution.text.TextBuilder.toCharArray(), and javolution.text.TextBuilder.toString().

◆ B0

final int javolution.text.TextBuilder.B0 = 5

staticprivate

Definition at line 34 of file TextBuilder.java.

◆ B1

final int javolution.text.TextBuilder.B1 = 10

staticprivate

Definition at line 36 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.charAt(), javolution.text.TextBuilder.contentEquals(), javolution.text.TextBuilder.getChars(), javolution.text.TextBuilder.increaseCapacity(), and javolution.text.TextBuilder.setCharAt().

◆ C0

final int javolution.text.TextBuilder.C0 = 1 << B0

staticprivate

Definition at line 35 of file TextBuilder.java.

◆ C1

final int javolution.text.TextBuilder.C1 = 1 << B1

staticprivate

Definition at line 37 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.getChars(), javolution.text.TextBuilder.increaseCapacity(), javolution.text.TextBuilder.toCharArray(), and javolution.text.TextBuilder.toString().

◆ DIGIT_TO_CHAR

final char [] javolution.text.TextBuilder.DIGIT_TO_CHAR

staticprivate

Initial value:

= { '0', '1', '2', '3', '4', '5',
            '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i',
            'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
            'w', 'x', 'y', 'z' }

Definition at line 475 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.append(), and javolution.text.TextBuilder.appendPositive().

◆ M1

final int javolution.text.TextBuilder.M1 = C1 - 1

staticprivate

Definition at line 38 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.append(), javolution.text.TextBuilder.charAt(), javolution.text.TextBuilder.contentEquals(), javolution.text.TextBuilder.getChars(), and javolution.text.TextBuilder.setCharAt().

◆ POW10_LONG

final long [] javolution.text.TextBuilder.POW10_LONG

staticprivate

Initial value:

= new long[] { 1L, 10L, 100L, 1000L,
            10000L, 100000L, 1000000L, 10000000L, 100000000L, 1000000000L,
            10000000000L, 100000000000L, 1000000000000L, 10000000000000L,
            100000000000000L, 1000000000000000L, 10000000000000000L,
            100000000000000000L, 1000000000000000000L }

Definition at line 686 of file TextBuilder.java.

Referenced by javolution.text.TextBuilder.append().

◆ serialVersionUID

final long javolution.text.TextBuilder.serialVersionUID = 0x600L

staticprivate

Definition at line 31 of file TextBuilder.java.

The documentation for this class was generated from the following file:

TextBuilder.java

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ TextBuilder() [1/3]

◆ TextBuilder() [2/3]

◆ TextBuilder() [3/3]

Member Function Documentation

◆ append() [1/18]

◆ append() [2/18]

◆ append() [3/18]

◆ append() [4/18]

◆ append() [5/18]

◆ append() [6/18]

◆ append() [7/18]

◆ append() [8/18]

◆ append() [9/18]

◆ append() [10/18]

◆ append() [11/18]

◆ append() [12/18]

◆ append() [13/18]

◆ append() [14/18]

◆ append() [15/18]

◆ append() [16/18]

◆ append() [17/18]

◆ append() [18/18]

◆ appendFraction()

◆ appendPositive() [1/2]

◆ appendPositive() [2/2]

◆ charAt()

◆ clear()

◆ contentEquals()

◆ delete()

◆ equals()

◆ getChars()

◆ hashCode()

◆ increaseCapacity()

◆ insert()

◆ length()

◆ reverse()

◆ setCharAt()

◆ setLength() [1/2]

◆ setLength() [2/2]

◆ subSequence()

◆ toCharArray()

◆ toLargeString()

◆ toString()

◆ toText()

Member Data Documentation

◆ _capacity

◆ _high

◆ _length

◆ _low

◆ B0

◆ B1

◆ C0

◆ C1

◆ DIGIT_TO_CHAR

◆ M1

◆ POW10_LONG

◆ serialVersionUID