org.plumelib.util

Class StringBuilderDelimited

java.lang.Object

org.plumelib.util.StringBuilderDelimited

All Implemented Interfaces:

java.lang.Appendable, java.lang.CharSequence

Deprecated.

use StringJoiner

@Deprecated
public class StringBuilderDelimited
extends java.lang.Object
implements java.lang.Appendable, java.lang.CharSequence

Like StringBuilder, but adds a delimiter between each pair of strings that are inserted into the StringBuilder. This can simplify the logic of programs and also avoid errors.

Does not extend StringBuilder because that would probably break, due to the possibility of calling the wrong version of append. Also, I don't (yet) want to override all the methods; this simpler version seems sufficient for the time being.

Obsoleted by the Java 8 StringJoiner class. Use only if your code must compile or run under Java 7.

Constructor Summary

Constructors

Constructor and Description
StringBuilderDelimited(java.lang.String delimiter) Deprecated. Create a new StringBuilderDelimited.

Method Summary

Modifier and Type	Method and Description
StringBuilderDelimited	add(@Nullable java.lang.CharSequence newElement) Deprecated. Appends the specified character sequence to this.
StringBuilderDelimited	append(char c) Deprecated. Use #add(CharSequence); change sbd.append(c) into sbd.add(c.toString())
StringBuilderDelimited	append(@Nullable java.lang.CharSequence csq) Deprecated. Use #add(CharSequence); change sbd.append(csq) into sbd.add(csq)
StringBuilderDelimited	append(@Nullable java.lang.CharSequence csq, int start, int end) Deprecated. Use #add(CharSequence); change sbd.append(csq, start, end) into sbd.add(csq.subSequence(start, end)
StringBuilderDelimited	append(@Nullable java.lang.Object o) Deprecated. Use #add(CharSequence); change sbd.append(o) into sbd.add(o.toString())
StringBuilderDelimited	append(@Nullable java.lang.String str) Deprecated. Use #add(CharSequence); change sbd.append(str) into sbd.add(str)
char	charAt(int index) Deprecated. Not supported by StringJoiner which will supersede this
int	length() Deprecated.
java.lang.CharSequence	subSequence(int start, int end) Deprecated. Not supported by StringJoiner which will supersede this
java.lang.String	toString() Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Constructor Detail

StringBuilderDelimited

public StringBuilderDelimited(java.lang.String delimiter)

Deprecated.

Create a new StringBuilderDelimited.

Parameters:

delimiter - the delimiter to be put between strings that are appended to this

Method Detail

add

public StringBuilderDelimited add(@Nullable java.lang.CharSequence newElement)

Deprecated.

Appends the specified character sequence to this.

Parameters:

newElement - the character sequence to append to this StringBuilderDelimited

Returns:

a reference to this StringBuilderDelimited

append

@Deprecated
public StringBuilderDelimited append(@Nullable java.lang.String str)

Deprecated. Use #add(CharSequence); change sbd.append(str) into sbd.add(str)

Appends the specified string to this.

Parameters:

str - the string to append to this StringBuilderDelimited

Returns:

a reference to this StringBuilderDelimited

append

@Deprecated
public StringBuilderDelimited append(@Nullable java.lang.Object o)

Deprecated. Use #add(CharSequence); change sbd.append(o) into sbd.add(o.toString())

Appends the specified object's printed representation to this.

Parameters:

o - the object whose toString() to append to this StringBuilderDelimited

Returns:

a reference to this StringBuilderDelimited

append

@Deprecated
public StringBuilderDelimited append(char c)

Deprecated. Use #add(CharSequence); change sbd.append(c) into sbd.add(c.toString())

Appends the specified character to this.

Specified by:

append in interface java.lang.Appendable

Parameters:

c - the character to append to this StringBuilderDelimited

Returns:

a reference to this StringBuilderDelimited

append

@Deprecated
public StringBuilderDelimited append(@Nullable java.lang.CharSequence csq)

Deprecated. Use #add(CharSequence); change sbd.append(csq) into sbd.add(csq)

Appends the specified character sequence to this.

Specified by:

append in interface java.lang.Appendable

Parameters:

csq - the character sequence to append to this StringBuilderDelimited

Returns:

a reference to this StringBuilderDelimited

append

@Deprecated
public StringBuilderDelimited append(@Nullable java.lang.CharSequence csq,
                                                 int start,
                                                 int end)

Deprecated. Use #add(CharSequence); change sbd.append(csq, start, end) into sbd.add(csq.subSequence(start, end)

Specified by:

append in interface java.lang.Appendable

charAt

@Deprecated
public char charAt(int index)

Deprecated. Not supported by StringJoiner which will supersede this

Specified by:

charAt in interface java.lang.CharSequence

length

@Pure
public int length(@GuardSatisfied StringBuilderDelimited this)

Deprecated.

Specified by:

length in interface java.lang.CharSequence

subSequence

@Deprecated
public java.lang.CharSequence subSequence(int start,
                                                      int end)

Deprecated. Not supported by StringJoiner which will supersede this

Specified by:

subSequence in interface java.lang.CharSequence

toString

@SideEffectFree
public java.lang.String toString(@GuardSatisfied StringBuilderDelimited this)

Deprecated.

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class java.lang.Object