plume

Class StringBuilderDelimited

java.lang.Object

plume.StringBuilderDelimited

All Implemented Interfaces:

java.lang.Appendable, java.lang.CharSequence

Deprecated.

use org.plumelib.util.StringBuilderDelimited

@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(java.lang.CharSequence newElement) Deprecated.
StringBuilderDelimited	append(char c) Deprecated. Use add(CharSequence); change sbd.append(c) into sbd.add(c.toString())
StringBuilderDelimited	append(java.lang.CharSequence csq) Deprecated. Use add(CharSequence); change sbd.append(csq) into sbd.add(csq)
StringBuilderDelimited	append(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(java.lang.Object o) Deprecated. Use add(CharSequence); change sbd.append(o) into sbd.add(o.toString())
StringBuilderDelimited	append(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(java.lang.CharSequence newElement)

Deprecated.

append

@Deprecated
public StringBuilderDelimited append(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(java.lang.Object o)

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

Appends the specified object's printed representatioin 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(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(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

public int length()

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

public java.lang.String toString()

Deprecated.

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class java.lang.Object