» Referenzen / Klassen / String

Die String - Klasse repräsentiert einen weiteren internen Datentyp von Java. Sie verwaltet Zeichenketten und ermöglicht deren umfangreiche Bearbeitung. Diese Strings sind allerdings konstant, können also nachträglich nicht weiter manipuliert werden.

Des weiteren werden String - Objekte nicht dynamisch angelegt. Die Verkettung von Strings ist über eine spezielle Verwendung des Plus - Operators bereits intern eingebaut.

» ab JDK Version 1.0

» Hierarchie

» Implementierung 

public final class String
extends Object
implements Serializable, Comparable
» Basisklasse » implementierte Schnittstellen

» Object
» Comparable
» Serializable
» Package java.lang

» Elemente

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

» Methoden » Konstruktoren

» charAt
» compareTo [1][2]
» compareToIgnoreCase
» concat
» copyValueOf [1][2]
» endsWith
» equals
» equalsIgnoreCase
» getBytes [1][2]
» getChars
» hashCode
» indexOf [1][2][3][4]
» intern
» lastIndexOf [1][2][3][4]
» length
» regionMatches [1][2]
» replace
» startsWith [1][2]
» substring [1][2]
» toCharArray
» toLowerCase [1][2]
» toString
» toUpperCase [1][2]
» trim
» valueOf [1][2][3][4][5][6][7][8][9]
» String (1)
» String (2)
» String (3)
» String (4)
» String (5)
» String (6)
» String (7)
» String (8)
» String (9)
» Datenelemente » Destruktoren

» CASE_INSENSITIVE_ORDER
keine

» Konstruktoren / Object (1)

Der Standardkonstruktor instanziiert ein leeres Objekt.

» Prototyp 

public String()
» Parameter

keine
» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Konstruktoren / Object (2)

Der Konstruktor initialisiert ein leeres Objekt mit einem Array von Zahlenwerten. Diese werden anhand des Unicode - Zeichensatzes in ihre entsprechenden Zeichencodes umgewandelt.

» Prototyp 

public String(byte[] array)
» Parameter

array Das Array mit den Zahlenwerten.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.1

» Konstruktoren / Object (3)

Der Konstruktor initialisiert ein leeres Objekt mit einem Array von Zahlenwerten. Diese werden anhand des Unicode - Zeichensatzes in ihre entsprechenden Zeichencodes umgewandelt. Die zu verwendenden Elemente des Arrays werden ab einer spezifizierten Position und einer bestimmten Länge ausgelesen.

» Prototyp 

public String(byte[] array,int offset,int length)
» Parameter

array Das Array mit den Zahlenwerten.
offset Ab der zu beginnenden Position.
length Anzahl der auszulesenden Elemente.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.1

» Konstruktoren / Object (4)

Der Konstruktor initialisiert ein leeres Objekt mit einem Array von Zahlenwerten. Diese werden anhand des Unicode - Zeichensatzes in ihre entsprechenden Zeichencodes umgewandelt. Die zu verwendenden Elemente des Arrays werden ab einer spezifizierten Position und einer bestimmten Länge ausgelesen. Die Bezeichnung des zu verwendenden Zeichensatzes wird ebenfalls angegeben.

» Prototyp 

public String(byte[] array,int offset,int length,String set)
throws UnsupportedEncodingException
» Parameter

array Das Array mit den Zahlenwerten.
offset Ab der zu beginnenden Position.
length Anzahl der auszulesenden Elemente.
set Der zu verwendende Zeichensatz.

US-ASCII ASCII Konvertierung mit sieben Bit.
ISO-8859-1Standard Unicode Konvertierung.
UTF-8 Unicode Konvertierung mit acht Bit.
UTF-16 Unicode Konvertierung mit sechzehn Bit.

» Ausnahmen & Fehler

UnsupportedEncodingException
Der Name des zu verwendenden Zeichensatzes ist unbekannt.
IndexOutOfBoundsException
Angaben zu Offset und Anzahl überschreiten das Array.

» ab JDK Version 1.1

» Konstruktoren / Object (5)

Der Konstruktor initialisiert ein leeres Objekt mit einem Array von Zahlenwerten. Diese werden anhand des Unicode - Zeichensatzes in ihre entsprechenden Zeichencodes umgewandelt. Die Bezeichnung des zu verwendenden Zeichensatzes wird ebenfalls angegeben.

» Prototyp 

public String(byte[] array,String set)
throws UnsupportedEncodingException
» Parameter

array Das Array mit den Zahlenwerten.
set Der zu verwendende Zeichensatz.

US-ASCII ASCII Konvertierung mit sieben Bit.
ISO-8859-1Standard Unicode Konvertierung.
UTF-8 Unicode Konvertierung mit acht Bit.
UTF-16 Unicode Konvertierung mit sechzehn Bit.

» Ausnahmen & Fehler

UnsupportedEncodingException
Der Name des zu verwendenden Zeichensatzes ist unbekannt.

» ab JDK Version 1.1

» Konstruktoren / Object (6)

Der Konstruktor initialisiert ein leeres Objekt mit einem Array von Zeichen. Diese werden anhand des Unicode - Zeichensatzes in ihre entsprechenden Zeichencodes umgewandelt.

» Prototyp 

public String(char[] array)
» Parameter

array Das Array mit den Zeichen.

» Ausnahmen & Fehler

NullPointerException
Die Referenz auf das Array ist null.

» ab JDK Version 1.0

» Konstruktoren / Object (7)

Der Konstruktor initialisiert ein leeres Objekt mit einem Array von Zeichen. Diese werden anhand des Unicode - Zeichensatzes in ihre entsprechenden Zeichencodes umgewandelt.

» Prototyp 

public String(char[] array,int offset,int length)
» Parameter

array Das Array mit den Zeichen.
offset Ab der zu beginnenden Position.
length Anzahl der auszulesenden Elemente.

» Ausnahmen & Fehler

IndexOutOfBoundsException
Angaben zu Offset und Anzahl überschreiten das Array.
NullPointerException
Die Referenz auf das Array ist null.

» ab JDK Version 1.0

» Konstruktoren / Object (8)

Der Konstruktor initialisiert ein leeres Objekt mit einem einem weiteren String.

» Prototyp 

public String(String string)
» Parameter

string Mit dem zu initialisierenden String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Konstruktoren / Object (9)

Der Konstruktor initialisiert ein leeres Objekt mit einem einem String - Puffer.

» Prototyp 

public String(StringBuffer buffer)
» Parameter

buffer Mit dem zu initialisierenden Puffer.

» Ausnahmen & Fehler

NullPointerException
Die Referenz auf den Puffer ist null.

» ab JDK Version 1.0

» Datenelemente / CASE_INSENSITIVE_ORDER

Liefert ein Vergleichsobjekt das Strings sortiert.

» Prototyp 

public static final Comparator CASE_INSENSITIVE_ORDER
» ab JDK Version 1.2

» 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 / compareTo (Implementierung)

Die Methode vergleicht zwei Strings miteinander. Der lexikalische Vergleich wird immer zwischen den korrrespondierenden Zeichen an ihrer Indexposition durchgeführt. Der Vergleich kann ausschließlich zwischen zwei Strings durchgeführt werden.

» Prototyp 

public int compareTo(String string)
public int compareTo(Object object)
» Parameter

string Mit dem zu vergleichenden String.
object Mit dem zu vergleichenden Objekt. Dieses wird lediglich in einen String konvertiert.

» Rückgabe

Wert < 0 Das Argument ist lexikalisch größer.
Wert > 0 Das Argument ist lexikalisch kleiner.
       0 Die Strings sind gleich.

» Ausnahmen & Fehler

NullPointerException
Die Referenz auf den Vergleichsstring ist null.

» ab JDK Version 1.0 / 1.2

» Methoden / compareToIgnoreCase

Die Methode vergleicht zwei Strings miteinander. Der lexikalische Vergleich wird immer zwischen den korrrespondierenden Zeichen an ihrer Indexposition durchgeführt. Der Vergleich kann ausschließlich zwischen zwei Strings durchgeführt werden. Die Groß- und Kleinschreibung wird ignoriert.

» Prototyp 

public int compareToIgnoreCase(String string)
» Parameter

string Mit dem zu vergleichenden String.

» Rückgabe

Wert < 0 Das Argument ist lexikalisch größer.
Wert > 0 Das Argument ist lexikalisch kleiner.
       0 Die Strings sind gleich.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.2

» Methoden / concat

Die Methode hängt einen String an den aktuellen an und liefert ein neues Objekt zurück. Die Anfügeposition ist stets das Ende des aktuellen Obejkts.

» Prototyp 

public String concat(String string)
» Parameter

string Der anzuhängende String.

» Rückgabe

String Der neu zusammengesetzte String.

» Ausnahmen & Fehler

NullPointerException
Die Referenz auf den String ist null.

» ab JDK Version 1.0

» Methoden / copyValueOf [1]

Die Methode kopiert den Inhalt eines Zeichenarrays in einen neuen String liefert diesen zurück.

» Prototyp 

public static String copyValueOf(char[] array)
» Parameter

array Das zu konvertierende Zeichenarray.

» Rückgabe

String Der neue String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / copyValueOf [2]

Die Methode kopiert den Inhalt eines Zeichenarrays in einen neuen String liefert diesen zurück. Die zu übertragenden Zeichen lassen sich durch eine Positionsangabe und die Anzahl der betroffenen Zeichen ab dieser Position bestimmen.

» Prototyp 

public static String copyValueOf(char[] array,int offset,int length)
» Parameter

array Das zu konvertierende Zeichenarray.
offset Ab der zu beginnenden Position.
length Anzahl der auszulesenden Elemente.

» Rückgabe

String Der neue String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / endsWith

Die Methode prüft, ob der aktuelle String mit einer bestimmten Zeichenkette endet.

» Prototyp 

public boolean endsWith(String suffix)
» Parameter

suffix Auf die zu prüfende Zeichenkette.

» Rückgabe

true Der String endet mit der Zeichenkette.
false Der String endet nicht mit der Zeichenkette.

» Ausnahmen & Fehler

NullPointerException
Die Referenz auf den Vergleichsstring ist null.

» ab JDK Version 1.0

» Methoden / equals (Redefinition)

Die Methode prüft, ob zwei Strings identisch sind.

» Prototyp 

public boolean equals(Object object)
» Parameter

object Mit dem zu prüfenden Objekt.

» Rückgabe

true Die Strings sind gleich.
false Die Strings sind ungleich.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / equalsIgnoreCase

Die Methode prüft, ob zwei Strings identisch sind. Dabei wird nicht die Groß- und Kleinschreibung unterschieden.

» Prototyp 

public boolean equalsIgnoreCase(String string)
» Parameter

string Mit dem zu vergleichenden String.

» Rückgabe

true Die Strings sind gleich.
false Die Strings sind ungleich.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / getBytes [1]

Die Methode liefert den aktuellen String in einem Byte - Array zurück. Dabei werden alle Zeichen in ihre entsprechenden Bytes konvertiert.

» Prototyp 

public byte[] getBytes()
» Parameter

keine
» Rückgabe

Array Das Byte - Array mit den entsprechenden Werten.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.1

» Methoden / getBytes [2]

Die Methode liefert den aktuellen String in einem Byte - Array zurück. Dabei werden alle Zeichen in ihre entsprechenden Bytes konvertiert. Die Art der Konvertierung kann ebenfalls spezifiziert werden.

» Prototyp 

public byte[] getBytes(String set)
throws UnsupportedEncodingException
» Parameter

set Der zu verwendende Zeichensatz.

US-ASCII ASCII Konvertierung mit sieben Bit.
ISO-8859-1Standard Unicode Konvertierung.
UTF-8 Unicode Konvertierung mit acht Bit.
UTF-16 Unicode Konvertierung mit sechzehn Bit.

» Rückgabe

Array Das Byte - Array mit den entsprechenden Werten.

» Ausnahmen & Fehler

UnsupportedEncodingException
Der Name des zu verwendenden Zeichensatzes ist unbekannt.

» ab JDK Version 1.1

» Methoden / getChars

Die Methode kopiert eine Zeichensequenz des aktuellen Strings in ein Zeichenarray.

» Prototyp 

public void getChars(int begin,int end,char[] target,int start)
» Parameter

begin Anfang der zu kopierenden Sequenz.
end Ende der zu kopierenden Sequenz.
target Zielarray des Kopiervorgangs.
start Einfügeposition im Zielarray.

» Rückgabe

keine
» Ausnahmen & Fehler

IndexOutOfBoundsException
Es wurde ein negativer Wert bei der Positionsangabe übergeben. Der Anfangsindex ist größer als der Endindex oder dieser ist größer als der aktuelle String. Die zu kopierende Sequenz überschreitet das Zielarray.
NullPointerException
Die Referenz auf das Zielarray ist null.

» ab JDK Version 1.0

» Methoden / hashCode (Redefinition)

Die Methode liefert einen Hashwert für den String.

» Prototyp 

public int hashCode()
» Parameter

keine
» Rückgabe

Wert Der Hashwert des Strings.
0 Der String ist leer.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / indexOf [1][2]

Die Methode liefert die erste Position eines eventuell im String vorhandenen Zeichens oder Strings.

» Prototyp 

public int indexOf(   int character)
public int indexOf(String    string)
» Parameter

character Das zu suchende Zeichen.
string Der zu suchende String.

» Rückgabe

Wert Der Index der ersten Fundstelle.
-1 Das gesuchte Zeichen oder String ist nicht enthalten.

» Ausnahmen & Fehler

keine
» ab JDK Version alle 1.0

» Methoden / indexOf [3][4]

Die Methode liefert die erste Position eines eventuell im String vorhandenen Zeichens oder Strings. Der Beginn der Suche kann ab einer bestimmten Indexposition angegeben werden.

» Prototyp 

public int indexOf(   int character,int index)
public int indexOf(String    string,int index)
» Parameter

character Das zu suchende Zeichen.
string Der zu suchende String.
index Ab dem zu beginnenden Index. Ist die Angabe negativ, so wird ab dem ersten Element begonnen. Ist die Angabe größer als der String, so wird ab dem letzten Element begonnen.

» Rückgabe

Wert Der Index der ersten Fundstelle.
-1 Das gesuchte Zeichen oder String ist nicht enthalten.

» Ausnahmen & Fehler

keine
» ab JDK Version alle 1.0

» Methoden / intern

Die Methode liefert die interne Repräsentation des Strings. Dabei handelt es sich im allgemeinen um die intern verwaltete Zeichenkette.

» Prototyp 

public String intern()
» Parameter

keine
» Rückgabe

String Die interne Zeichenkette.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / lastIndexOf [1][2]

Die Methode liefert die letzte Position eines eventuell im String vorhandenen Zeichens oder Strings.

» Prototyp 

public int lastIndexOf(   int character)
public int lastIndexOf(String    string)
» Parameter

character Das zu suchende Zeichen.
string Der zu suchende String.

» Rückgabe

Wert Der Index der letzten Fundstelle.
-1 Das gesuchte Zeichen oder String ist nicht enthalten.

» Ausnahmen & Fehler

keine
» ab JDK Version alle 1.0

» Methoden / lastIndexOf [3][4]

Die Methode liefert die letzte Position eines eventuell im String vorhandenen Zeichens oder Strings. Der Beginn der Suche kann ab einer bestimmten Indexposition angegeben werden.

» Prototyp 

public int lastIndexOf(   int character,int index)
public int lastIndexOf(String    string,int index)
» Parameter

character Das zu suchende Zeichen.
string Der zu suchende String.
index Ab dem zu beginnenden Index. Ist die Angabe negativ, so wird ab dem ersten Element begonnen. Ist die Angabe größer als der String, so wird ab dem letzten Element begonnen.

» Rückgabe

Wert Der Index der letzten Fundstelle.
-1 Das gesuchte Zeichen oder String ist nicht enthalten.

» Ausnahmen & Fehler

keine
» ab JDK Version alle 1.0

» 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 / regionMatches [1][2]

Die Methode vergleicht eine Sequenz des aktuellen Strings mit einem anderen Stringargument. Dabei können die Startpositionen in beiden Strings bestimmt werden. Die Groß- und Kleinschreibung kann ignoriert werden.

» Prototyp 

public boolean regionMatches(
             int begin1,String string,int begin2,int length)
public boolean regionMatches(
boolean case,int begin1,String string,int begin2,int length)
» Parameter

case Bei True wird die Groß - und Kleinschreibung ignoriert.
string Mit dem zu vergleichenden String.
begin1 Startposition im aktuellen String.
begin2 Startposition im übergebenen String.
length Anzahl der maximal zu vergleichenden Elemente.

» Rückgabe

true Die gesuchte Sequenz ist enthalten.
false Die gesuchte Sequenz ist nicht enthalten.

» Ausnahmen & Fehler

NullPointerException
Die Referenz auf den übergebenen String ist null.

» ab JDK Version alle 1.0

» Methoden / replace

Die Methode ersetzt ein spezifisches Zeichen durch ein anderes.

» Prototyp 

public String replace(char old,char new)
» Parameter

old Das zu erstzende Zeichen.
new Mit dem zu ersetzenden Zeichen.

» Rückgabe

String Ein neuer String mit den Änderungen.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / startsWith [1][2]

Die Methode prüft, ob der aktuelle String mit einer bestimmten Zeichenkette beginnt. Die Startposition ab der zu suchen ist läßt sich ebenfalls bestimmen.

» Prototyp 

public boolean startsWith(String prefix          )
public boolean startsWith(String prefix,int index)
» Parameter

prefix Auf die zu prüfende Zeichenkette.
index Ab dem zu beginnenden Index.

» Rückgabe

true Der String beginnt mit der Zeichenkette.
false Der String beginnt nicht mit der Zeichenkette.

» Ausnahmen & Fehler

NullPointerException
Die Referenz auf den Vergleichsstring ist null.

» ab JDK Version alle 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

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

» ab JDK Version alle 1.0

» Methoden / toCharArray

Die Methode gibt den String in Form eines Zeichen - Arrays zurück.

» Prototyp 

public char[] toCharArray()
» Parameter

keine
» Rückgabe

Array Der String als Zeichenarray.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / toLowerCase [1][2]

Die Methode konvertiert alle Zeichen des Strings in Kleinbuchstaben. Optional kann dazu ein Locale verwendet werden.

» Prototyp 

public String toLowerCase(             )
public String toLowerCase(Locale locale)
» Parameter

locale Das zu verwendende Locale.

» Rückgabe

String Der neue String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0 / 1.1

» Methoden / toString (Redefinition)

Die Methode liefert das aktuelle Objekt zurück.

» Prototyp 

public String toString()
» Parameter

keine
» Rückgabe

String Der aktuelle String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / toUpperCase [1][2]

Die Methode konvertiert alle Zeichen des Strings in Großbuchstaben. Optional kann dazu ein Locale verwendet werden.

» Prototyp 

public String toUpperCase(             )
public String toUpperCase(Locale locale)
» Parameter

locale Das zu verwendende Locale.

» Rückgabe

String Der neue String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0 / 1.1

» Methoden / trim

Die Methode entfernt alle Leerzeichen am Anfang und Ende des Strings.

» Prototyp 

public String trim()
» Parameter

keine
» Rückgabe

String Der neue String.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / valueOf [1][2][3][4][5][6]

Die Methode erzeugt eine String - Repräsentation des übergebenen Datentyps.

» Prototyp 

public static String valueOf(boolean value)
public static String valueOf(char    value)
public static String valueOf(double  value)
public static String valueOf(float   value)
public static String valueOf(int     value)
public static String valueOf(long    value)
» Parameter

value Der darzustellende Wert.

» Rückgabe

String Der neue String als Repräsentation des Wertes.

» Ausnahmen & Fehler

keine
» ab JDK Version alle 1.0

» Methoden / valueOf [7]

Die Methode erzeugt eine String - Repräsentation des übergebenen Datentyps. Hierbei wird die interne Stringrepräsentation jedes Objekts abgefragt.

» Prototyp 

public static String valueOf(Object object)
» Parameter

object Das darzustellende Objekt. Ist die Referenz null, dann heißt auch der String null.

» Rückgabe

String Der neue String als Repräsentation des Objekts.

» Ausnahmen & Fehler

keine
» ab JDK Version 1.0

» Methoden / valueOf [8][9]

Die Methode erzeugt eine String - Repräsentation des übergebenen Arrays. Hierbei kann auch Startposition und Anzahl der zu überführenden Zeichen angegeben werden.

» Prototyp 

public static String valueOf(char[] array                      )
public static String valueOf(char[] array,int offset,int length)
» Parameter

array Das darzustellende Array.
offset Ab der zu beginnenden Position.
length Anzahl der zu überführenden Elemente.

» Rückgabe

String Der neue String als Repräsentation des Arrays.

» Ausnahmen & Fehler

IndexOutOfBoundsException
Die Positionsangaben sind negativ oder überschreiten das Array.
NullPointerException
Die Referenz auf das Array ist null.

» ab JDK Version alle 1.0