» Referenzen / Klassen / StringBuffer

Ein StringBuffer - Objekt verhält sich ähnlich wie ein String, ist allerdings durch die Möglichkeit seiner Manipulation erweitert worden.

» ab JDK Version 1.0

» Hierarchie

» Implementierung 

public final class StringBuffer
extends Object
implements Serializable
» Basisklasse » implementierte Schnittstellen

» Object
» Serializable
» Package java.lang

» Elemente

In der folgenden Liste sind alle von uns bereits referenzierten Elemente der Klasse aufgeführt.

» Methoden » Konstruktoren

» append (Teil 1) [1][2][3][4][5][6][7][8]
» append (Teil 2) [1][2]
» capacity
» charAt
» delete
» deleteCharAt
» ensureCapacity
» getChars
» insert (Teil 1) [1][2][3][4][5][6][7][8]
» insert (Teil 2) [1][2]
» length
» replace
» reverse
» setCharAt
» setLength
» substring[1][2]
» toString
» StringBuffer (1)
» StringBuffer (2)
» StringBuffer (3)
» Datenelemente » Destruktoren

keine
keine

» Konstruktoren / StringBuffer (1)

Der Standardkonstruktor erzeugt ein Objekt ohne Zeichen mit einer Kapazität von 16 Zeichen.

» Prototyp 

public String()
» Parameter

keine
» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Konstruktoren / StringBuffer (2)

Der Standardkonstruktor erzeugt ein Objekt ohne Zeichen mit einer spezifischen Kapazität.

» Prototyp 

public StringBuffer(int length)
» Parameter

length Die Kapazität des Objekts.

» Ausnahmen & Fehler

NegativeArraySizeException
Die Angabe der Zeichenkapazität ist kleiner null.

» ab JDK Version 1.0

» Konstruktoren / StringBuffer (3)

Der Standardkonstruktor erzeugt ein Objekt als Kopie eines Strings. Die neue Kapazität entspricht der Zeichenanzahl des kopierten Strings plus 16 Zeichen.

» Prototyp 

public StringBuffer(String string)
» Parameter

string Der zu kopierende String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / append (Teil 1) [1][2][3][4][5][6][7][8]

Die Methode hängt einen Wert an den aktuellen String an. Dabei wird eine Stringrepräsentation der unterschiedlichen Datentypen verwendet.

» Prototyp 

public StringBuffer append(boolean value)
public StringBuffer append(char    value)
public StringBuffer append(double  value)
public StringBuffer append(float   value)
public StringBuffer append(int     value)
public StringBuffer append(long    value)
public StringBuffer append(Object  value)
public StringBuffer append(String  value)
» Parameter

value Der anzuhängende Wert oder Objekt.

» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

keine
» ab JDK Version alle 1.0

» Methoden / append (Teil 2) [1][2]

Die Methoden hängen den Inhalt eines Char - Arrays an den aktuellen String an. Dabei kann optional der Startindex und die Anzahl der Zeichen des Quellarrays bestimmt werden.

» Prototyp 

public StringBuffer append(char[] array                     )
public StringBuffer append(char[] array,int index,int length)
» Parameter

array Das Quellarray welches anzuhängen ist.
index Der Startindex des Quellarrays, ab dem zu beginnen ist.
length Die Anzahl der anzuhängenden Zeichen.

» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

keine
» ab JDK Version alle 1.0

» Methoden / capacity

Die Methoden liefert den aktuellen Kapazitätswert des Objekts.

» Prototyp 

public int capacity()
» Parameter

keine
» Rückgabe

Wert Der aktuelle Kapazitätswert.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / charAt

Die Methode liefert das Zeichen an einer spezifizierten Position.

» Prototyp 

public char charAt(int index)
» Parameter

index Der Index des zu liefernden Elements.

» Rückgabe

Zeichen Das Zeichen an der Position.

» Ausnahmen & Fehler

IndexOutOfBoundsException
Die Indexangabe ist negativ oder größer als das Array.

» ab JDK Version 1.0

» Methoden / delete

Die Methode löscht eine Sequenz von Zeichen des aktuellen Strings.

» Prototyp 

public StringBuffer delete(int start,int end)
» Parameter

start Anfang der Sequenz.
end Ende der Sequenz.

» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

IndexOutOfBoundsException
Die Indexangaben sind negativ, größer als die aktuelle Anzahl von Zeichen oder überschreiten das Ende des Strings.

» ab JDK Version 1.2

» Methoden / deleteCharAt

Die Methode löscht ein Zeichen des aktuellen Strings.

» Prototyp 

public StringBuffer deleteCharAt(int index)
» Parameter

index Die Indexposition des zu löschenden Zeichens.

» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

IndexOutOfBoundsException
Die Indexangabe ist negativ, größer als die aktuelle Anzahl von Zeichen oder überschreiten das Ende des Strings.

» ab JDK Version 1.2

» Methoden / ensureCapacity

Die Methode garantiert, dass die aktuelle Kapazität mindestens den spezifizierten Wert hat. Wenn der aktuelle Wert unter der Angabe des übergebenen Parameters liegt, so wird eine Neuallokation mit größerer Kapazität durchgeführt. Diese ist dann doppelt so groß wie der vorhergehende Puffer plus zwei. Wird ein negativer Wert übergeben, so führt die Methode keine Aktionen aus.

» Prototyp 

public void ensureCapacity(int value)
» Parameter

value Der neue minimale Kapazitätswert.

» Rückgabe

keine
» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / getChars

Die Methode kopiert eine Zeichensequenz des aktuellen Strings in ein Char - Array.

» Prototyp 

public void getChars(int begin1,int end,char[] target,int begin2)
» Parameter

begin1 Startposition im aktuellen String.
begin2 Startposition im Zielarray.
end Endposition im aktuellen String.
target Das Zielarray welches zu füllen ist.

» Rückgabe

keine
» Ausnahmen & Fehler

NullPointerException
Die Referenz auf das Zielarray ist null.
IndexOutOfBoundsException
Die Indexangaben sind negativ, die Startposition ist größer als die Endposition, überschreiten den aktuellen String oder das Zielarray.

» ab JDK Version 1.0

» Methoden / insert (Teil 1) [1][2][3][4][5][6][7][8]

Die Methode fügt die Stringrepräsentation eines elementaren Datentyps oder eines Objekts an einer spezifischen Position im aktuellen String ein.

» Prototyp 

public StringBuffer insert(int index,boolean value)
public StringBuffer insert(int index,char    value)
public StringBuffer insert(int index,double  value)
public StringBuffer insert(int index,float   value)
public StringBuffer insert(int index,int     value)
public StringBuffer insert(int index,long    value)
public StringBuffer insert(int index,Object  value)
public StringBuffer insert(int index,String  value)
» Parameter

index Ab der einzufügenden Position.
value Der einzufügende Wert oder Objekt.

» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

StringIndexOutOfBoundsException
Die Indexposition ist ungültig.

» ab JDK Version alle 1.0

» Methoden / insert (Teil 2) [1][2]

Die Methode fügt die Stringrepräsentation eines Char - Arrays an einer spezifischen Position im aktuellen String ein.

» Prototyp 

public StringBuffer insert(int index,char[] array)
public StringBuffer insert(int index,char[] array,
                            int offset,int length)
» Parameter

index Ab der einzufügenden Position.
array Das einzufügende Array von Zeichen.
offset Startposition des einzufügenden Strings im Quellarray.
length Anzahl der einzufügenden Zeichen des Quellarrays.

» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

StringIndexOutOfBoundsException
Die Indexposition ist ungültig, negativ oder gößer als die Längenangabe im Quellarray und als im Zielstring.

» ab JDK Version 1.0 / 1.2

» Methoden / length

Die Methode liefert die Länge des Strings. Diese entspricht der Anzahl von Zeichen im String.

» Prototyp 

public int length()
» Parameter

keine
» Rückgabe

Wert Länge des Strings.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / replace

Die Methode ersetzt eine Zeichensequenz des aktuellen Strings durch einen anderen String.

» Prototyp 

public StringBuffer replace(int start,int end,String string)
» Parameter

start Anfang der zu ersetzenden Sequenz.
end Ende der zu ersetzenden Sequenz.
string Durch den zu ersetzenden String.

» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

StringIndexOutOfBoundsException
Der Startindex ist negativ, größer als das Ende oder als das Ende des aktuellen Strings.

» ab JDK Version 1.2

» Methoden / reverse

Die Methode kehrt die Reihenfolge der aktuellen Zeichenkette um.

» Prototyp 

public StringBuffer reverse()
» Parameter

keine
» Rückgabe

Objekt Eine Referenz auf das aktuelle Objekt.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / setCharAt

Die Methode setzt ein Zeichen an einer spezifizierten Indexposition.

» Prototyp 

public void setCharAt(int index,char value)
» Parameter

index Die zu setzende Indexposition.
value Das zu setzende Zeichen.

» Rückgabe

keine
» Ausnahmen & Fehler

IndexOutOfBoundsException
Die Indexangabe ist negativ oder größer gleich der aktuellen Länge des Strings.

» ab JDK Version 1.0

» Methoden / setLength

Die Methode setzt eine neue Länge für das aktuelle Objekt. Ist der neue Wert kleiner als die aktuelle Länge, so werden überstehende Zeichen angeschnitten. Ansonsten werden leerstellen durch Leerzeichen aufgefüllt, so fern der neue Wert größer ist als die aktuelle Länge.

» Prototyp 

public void setLength(int value)
» Parameter

value Die neue Länge des Strings.

» Rückgabe

keine
» Ausnahmen & Fehler

IndexOutOfBoundsException
Die Längenangabe ist negativ.

» ab JDK Version 1.0

» Methoden / substring [1][2]

Die Methode liefert einen Substring ab einer bestimmten Position. Wird kein Ende angegeben, so ist dieses automatisch am Ende des aktuellen strings.

» Prototyp 

public String substring(int begin        )
public String substring(int begin,int end)
» Parameter

begin Anfang des Substrings.
end Ende des Substrings.

» Rückgabe

String Der neue Substring.

» Ausnahmen & Fehler

StringIndexOutOfBoundsException
Die Anfangsposition ist negativ. Sowohl Anfang als auch Ende gehen über das Stringende hinaus.

» ab JDK Version alle 1.2

» Methoden / toString (Redefinition)

Die Methode liefert eine Stringrepräsentation des aktuellen Objekts.

» Prototyp 

public String toString()
» Parameter

keine
» Rückgabe

String Der neue String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0