java.lang.Object
   |
   +--java.lang.String

Deklaration

Beschreibung

Konstruktoren
public	String()
public	String(String value)
public	String(StringBuffer buffer)
public	String(char[] value)
public	String(char[] value, int offset, int count)
public	String(byte[] ascii, int hibyte)       Verworfen in Version 1.2.
public	String(byte[] ascii, int hibyte, int offset, int count)       Verworfen in Version 1.2.
public	String(byte[] bytes)
public	String(byte[] bytes, int offset, int length)
public	String(byte[] bytes, String enc)
public	String(byte[] bytes, int offset, int length, String enc)

Methoden
public char	charAt(int index)
public int	compareTo(String anotherString)
public int	compareTo(Object o)
public int	compareToIgnoreCase(String str)
public String	concat(String str)
public boolean	contentEquals(StringBuffer sb)
public static String	copyValueOf(char[] data)
public static String	copyValueOf(char[] data, int offset, int count)
public boolean	endsWith(String suffix)
public boolean	equals(Object obj)
public boolean	equalsIgnoreCase(String anotherString)
public byte[]	getBytes()
public byte[]	getBytes(String enc)
public void	getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin)       Verworfen in Version 1.1.
public void	getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)
public int	hashCode()
public int	indexOf(String str)
public int	indexOf(int ch)
public int	indexOf(String str, int fromIndex)
public int	indexOf(int ch, int fromIndex)
public native String	intern()
public int	lastIndexOf(int ch)
public int	lastIndexOf(String str)
public int	lastIndexOf(int ch, int fromIndex)
public int	lastIndexOf(String str, int fromIndex)
public int	length()
public boolean	matches(String regex)
public boolean	regionMatches(int toffset, String other, int ooffset, int len)
public boolean	regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)
public String	replace(char oldChar, char newChar)
public String	replaceAll(String regex, String replacement)
public String	replaceFirst(String regex, String replacement)
public String[]	split(String regex)
public String[]	split(String regex, int limit)
public boolean	startsWith(String prefix)
public boolean	startsWith(String prefix, int toffset)
public CharSequence	subSequence(int beginIndex, int endIndex)
public String	substring(int beginIndex)
public String	substring(int beginIndex, int endIndex)
public char[]	toCharArray()
public String	toLowerCase()
public String	toLowerCase(Locale locale)
public String	toString()
public String	toUpperCase()
public String	toUpperCase(Locale locale)
public String	trim()
public static String	valueOf(boolean b)
public static String	valueOf(char c)
public static String	valueOf(int i)
public static String	valueOf(long l)
public static String	valueOf(float f)
public static String	valueOf(double d)
public static String	valueOf(char[] data)
public static String	valueOf(Object obj)
public static String	valueOf(char[] data, int offset, int count)

Konstruktoren im Detail

public String()

Erzeugt ein neues String-Objekt, das mit einem leeren String initialisiert wird.

public String(String value)

Erzeugt ein neues String-Objekt, das mit einer Kopie des Inhalts von value initialisiert wird.

public String(StringBuffer buffer)

Erzeugt ein neues String-Objekt, das mit dem momentanen Wert des StringBuffer-Objekts buffer initialisiert wird. Dessen Inhalt wird nicht kopiert, sondern der Datenbereich wird gemeinsam genutzt.

public String(char[] value)

Erzeugt ein neues String-Objekt, das mit einem char-Array initialisiert wird. Das Array wird hierbei in einen internen Puffer kopiert.

public String(char[] value, int offset, int count)

Erzeugt ein neues String-Objekt, das mit count Zeichen ab dem Index offset aus einem char-Array initialisiert wird. Das Array wird hierbei in einen internen Puffer kopiert.

Exception: StringIndexOutOfBoundsException

• Falls offset oder count kleiner als null sind.
• Wenn die Summe von offset und count größer als die Länge von value ist.

public String(byte[] ascii, int hibyte)

Erzeugt ein neues String-Objekt, das mit einem byte-Array initialisiert wird. Das Array wird hierbei in einen internen Puffer kopiert. Zusätzlich kann das High-Byte für die Unicode-Zeichen, aus denen der Ergebnis-String zusammengesetzt wird, angegeben werden. Üblicherweise wird null spezifiziert, wodurch sich der ASCII-Zeichensatz ergibt.

public String(byte[] ascii, int hibyte, int offset, int count)

Wie die vorangehende Variante, nur dass hier die ersten count Elemente ab dem Index offset aus ascii verwendet werden.

Exception: StringIndexOutOfBoundsException

• Falls offset oder count kleiner als null sind.
• Wenn die Summe von offset und count größer als die Länge von ascii ist.

public String(byte[] bytes)     

Erzeugt einen neuen String aus einem byte-Array, wobei zur Konvertierung der Bytes in Unicode-Zeichen die voreingestellte Zeichencodierung der Plattform verwendet wird. Das Array wird hierbei in einen internen Puffer kopiert.

public String(byte[] bytes, int offset, int length)

Wie die vorangehende Variante, nur dass hier die ersten length Bytes ab dem Index offset aus bytes verwendet werden.

public String(byte[] bytes, String enc)     

Erzeugt einen neuen String aus einem byte-Array, wobei zur Konvertierung der Bytes in Unicode-Zeichen die durch enc bezeichnete Zeichencodierung der Plattform verwendet wird. Das Array wird hierzu in einen internen Puffer kopiert.

Exception: UnsupportedEncodingException

• Falls die angegebene Codierung nicht unterstützt wird.

public String(byte[] bytes, int offset, int length, String enc)     

Wie die vorangehende Variante, nur dass hier die ersten length Bytes ab dem Index offset aus bytes verwendet werden.

Exception: UnsupportedEncodingException

• Falls die angegebene Codierung nicht unterstützt wird.

Methoden im Detail

public char charAt(int index)

Liefert das Zeichen aus dem String, das an der Position index steht. index wird hierbei von null an gezählt.

Exception: StringIndexOutOfBoundsException

• Falls index kleiner als null oder größer gleich der Länge des String ist.

public int compareTo(String anotherString)     

Liefert einen int-Wert, der kleiner als null ist, wenn dieser String lexikalisch kleiner ist als anotherString, null, wenn der String gleich anotherString ist, und einen Wert größer als null, wenn der String lexikalisch größer ist als anotherString.

public int compareTo(Object o)     

Liefert einen int-Wert, der kleiner als null ist, wenn dieser String lexikalisch kleiner ist als o, null, wenn der String gleich o ist, und einen Wert größer als null, wenn der String lexikalisch größer ist als o.

Exception: ClassCastException

• Falls für o kein Exemplar von String übergeben wird.

public int compareToIgnoreCase(String str)     

Vergleicht diesen String mit str ohne Berücksichtigung der Groß- und Kleinschreibung. Rückgabewert ist ein int-Wert, der kleiner als null ist, wenn dieser String lexikalisch kleiner ist als o, null, wenn der String gleich o ist, und einen Wert größer als null, wenn der String lexikalisch größer ist als o.

public String concat(String str)

Liefert einen neuen String, der die Verkettung dieses Strings mit str enthält.

public boolean contentEquals(StringBuffer sb)     

Liefert true, falls der Inhalt dieses Strings mit dem des StringBuffer-Objekts sb übereinstimmt, sonst false.

public static String copyValueOf(char[] data)

Liefert einen neuen String zurück, der aus einer Kopie von data erzeugt wird.

public static String copyValueOf(char[] data, int offset, int count)

Liefert einen neuen String, der aus einer Kopie der ersten count Zeichen ab der Position offset von data erzeugt wird, zurück.

public boolean endsWith(String suffix)

Liefert suffix, wenn die letzten Zeichen des Strings mit suffix übereinstimmen, sonst false.

public boolean equals(Object obj)

Liefert genau dann true, wenn obj ein Exemplar der Klasse String ist, das denselben Wert besitzt wie dieses Objekt, sonst false.

public boolean equalsIgnoreCase(String anotherString)

Liefert genau dann true, wenn anotherString nicht null ist und eine Zeichenkette enthält, die ohne Berücksichtigung der Groß- und Kleinschreibung mit der Zeichenkette dieses Exemplars übereinstimmt. Andernfalls wird false zurückgegeben.

public byte[] getBytes()     

Konvertiert den String in ein byte-Array, wobei zur Konvertierung der Unicode-Zeichen in Bytes die voreingestellte Zeichencodierung der Plattform verwendet wird.

public byte[] getBytes(String enc)     

Konvertiert den String in ein byte-Array, wobei zur Konvertierung der Unicode-Zeichen in Bytes die durch enc bezeichnete Zeichencodierung der Plattform verwendet wird.

Exception: UnsupportedEncodingException

• Falls die angegebene Codierung nicht unterstützt wird.

public void getBytes(int srcBegin, int srcEnd, byte[] dst, int dstBegin)

Kopiert die Zeichen ab der Position srcBegin bis zur Position srcEnd in das byte-Array dst, wobei keine Umcodierung der Zeichen vorgenommen wird (das höherwertige Byte der im String enthaltenen Zeichen wird ignoriert). srcEnd bezeichnet hierbei den Index hinter dem letzten Zeichen, das kopiert werden soll. dstBegin legt fest, ab welcher Position die Zeichen in den Puffer kopiert werden.

Exception: StringIndexOutOfBoundsException

• Falls srcBegin oder srcEnd größer als die Länge des Strings ist.

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

Kopiert die Zeichen ab der Position srcBegin bis zur Position srcEnd in das char-Array dst. srcEnd bezeichnet hierbei den Index hinter dem letzten Zeichen, das kopiert werden soll. dstBegin legt fest, ab welcher Position die Zeichen in den Puffer kopiert werden.

Exception: StringIndexOutOfBoundsException

• Falls srcBegin oder srcEnd größer als die Länge des Strings ist.
• Wenn srcBegin größer als srcEnd ist.

public int hashCode()

Liefert einen Hashcode für das String-Objekt.

public int indexOf(String str)

Liefert die erste Position, an der str vollständig im String enthalten ist. Ist str nicht im String enthalten, wird -1 geliefert.

public int indexOf(int ch)

Liefert die Position des ersten Vorkommens des Zeichens ch oder -1, falls das Zeichen nicht im String enthalten ist.

public int indexOf(String str, int fromIndex)

Liefert die erste Position, an der str vollständig im String enthalten ist, wobei ab der Position fromIndex mit der Suche begonnen wird. Ist str nicht in diesem Bereich enthalten, wird -1 geliefert.

public int indexOf(int ch, int fromIndex)

Liefert die Position des ersten Vorkommens des Zeichens ch, wobei ab der Position fromIndex mit der Suche begonnen wird. Ist das Zeichen nicht in diesem Bereich enthalten, wird -1 geliefert.

public native String intern()

Liefert ein neues Exemplar von String zurück, das denselben Datenbereich wie dieser String verwendet, so dass kein weiterer Speicherplatz für die Zeichen benötigt wird.

public int lastIndexOf(int ch)

Liefert die Position des letzten Vorkommens des Zeichens ch oder -1, wenn das Zeichen nicht im String enthalten ist.

public int lastIndexOf(String str)

Liefert die letzte Position, an der str vollständig im String enthalten ist. Ist str nicht im String enthalten, wird -1 geliefert.

public int lastIndexOf(int ch, int fromIndex)

Liefert die Position des letzten Vorkommens des Zeichens ch, wobei ab der Position fromIndex rückwärts gesucht wird. Ist das Zeichen nicht im String enthalten, wird -1 geliefert.

public int lastIndexOf(String str, int fromIndex)

Liefert die letzte Position, an der str vollständig im String enthalten ist, wobei ab der Position fromIndex rückwärts gesucht wird. Ist str nicht in diesem Bereich enthalten, wird -1 geliefert.

public int length()

Liefert die Länge des Strings.

public boolean matches(String regex)     

Liefert true, falls das im regulären Ausdruck regex angegebene Muster auf diesen String passt, sonst false.

Exception: PatternSyntaxException

• Falls regex eine ungültige Syntax hat.

Exception: NullPointerException

• Falls null übergeben wird.

public boolean regionMatches(int toffset, String other, int ooffset, int len)

Liefert true, wenn ein bestimmter Bereich des Strings mit einem Bereich von other übereinstimmt, sonst false. toffset definiert hierbei den Anfang des Bereichs im String, ooffset den Anfang des Bereichs in other. Der letzte Parameter len bestimmt die Anzahl an Zeichen, die übereinstimmen müssen.

public boolean regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)

Diese Variante von regionMatches erlaubt es, zusätzlich über den Parameter ignoreCase festzulegen, ob die Groß- und Kleinschreibung beim Vergleich beachtet werden soll oder nicht.

public String replace(char oldChar, char newChar)

Liefert einen neuen String, in dem alle Vorkommen von oldChar durch newChar ersetzt sind.

public String replaceAll(String regex, String replacement)     

Ersetzt alle Vorkommen des mit regex spezifizierten Ausdrucks mit dem Ersatztext replacement und liefert das Ergebnis zurück.

Exception: PatternSyntaxException

• Falls regex eine ungültige Syntax hat.

Exception: NullPointerException

• Falls null übergeben wird.

public String replaceFirst(String regex, String replacement)     

Ersetzt das erste Vorkommen des mit regex spezifizierten Ausdrucks mit dem Ersatztext replacement und liefert das Ergebnis zurück.

Exception: PatternSyntaxException

• Falls regex eine ungültige Syntax hat.

Exception: NullPointerException

• Falls null übergeben wird.

public String[] split(String regex)     

Splittet den String gemäß dem regulären Ausdruck regex auf und liefert die Teilstrings in einem String-Array zurück. Falls der Ausdruck nicht auf den String passt, wird ein Array mit genau einem Element zurückgegeben. Dieses Element ist der unveränderte String.

Exception: PatternSyntaxException

• Falls regex eine ungültige Syntax hat.

Exception: NullPointerException

• Falls null übergeben wird.

public String[] split(String regex, int limit)     

Splittet den String gemäß dem regulären Ausdruck regex auf und liefert die Teilstrings in einem String-Array zurück. Falls der Ausdruck nicht auf den String passt, wird ein Array mit genau einem Element zurückgegeben. Dieses Element ist der unveränderte String. limit bestimmt eine Obergrenze für die Treffer. Wenn für limit ein positiver Wert übergeben wird, ist das gelieferte Array höchstens so lang wie dieser Wert. Bei einem negativen Wert oder Null werden alle Treffer zurückgegeben. Bei Null werden leere Teilzeichenketten am Ende nicht berücksichtigt.

Exception: PatternSyntaxException

• Falls regex eine ungültige Syntax hat.

Exception: NullPointerException

• Falls null übergeben wird.

public boolean startsWith(String prefix)

Liefert true, wenn der String ab dem ersten Zeichen mit prefix übereinstimmt, sonst false. prefix darf nicht null sein.

public boolean startsWith(String prefix, int toffset)

Liefert true, wenn der String ab der Position toffset mitprefix übereinstimmt, sonst false. prefix darf nicht null sein.

public CharSequence subSequence(int beginIndex, int endIndex)     

Liefert eine CharSequence, die nur die Zeichen ab der Position beginIndex bis zur Position endIndex. endIndex bezeichnet hierbei den Index hinter dem letzten Zeichen, das kopiert werden soll.

public String substring(int beginIndex)

Liefert einen neuen String, der nur die Zeichen ab der Position beginIndex bis zum Ende dieses Strings enthält.

Exception: StringIndexOutOfBoundsException

• Falls beginIndex kleiner als null ist.

public String substring(int beginIndex, int endIndex)

Liefert einen neuen String, der nur die Zeichen ab der Position beginIndex bis zur Position endIndex. endIndex bezeichnet hierbei den Index hinter dem letzten Zeichen, das kopiert werden soll.

Exception: StringIndexOutOfBoundsException

• Falls beginIndex kleiner als null oder endIndex größer als die Länge des Strings ist.
• Wenn beginIndex größer als endIndex ist.

public char[] toCharArray()

Liefert die Zeichend des Strings in einem neu erzeugten char-Array zurück.

public String toLowerCase()

Liefert einen neuen String, in dem alle Großbuchstaben gemäß den voreingestellten länderspezifischen Einstellungen in Kleinbuchstaben umgewandelt sind.

public String toLowerCase(Locale locale)     

Liefert einen neuen String, in dem alle Großbuchstaben gemäß den übergebenen länderspezifischen Einstellungen in Kleinbuchstaben umgewandelt sind.

public String toString()

Liefert einen Verweis auf dieses String-Objekt.

public String toUpperCase()

Liefert einen neuen String, in dem alle Kleinbuchstaben gemäß den voreingestellten länderspezifischen Einstellungen in Großbuchstaben umgewandelt sind.

public String toUpperCase(Locale locale)     

Liefert einen neuen String, in dem alle Kleinbuchstaben gemäß den übergebenen länderspezifischen Einstellungen in Großbuchstaben umgewandelt sind.

public String trim()

Liefert einen neuen String, in dem alle Whitespace-Zeichen am Anfang und am Ende entfernt sind. Als Whitespace-Zeichen gelten in diesem Fall alle Zeichen kleiner oder gleich '\u0020', also insbesondere das Leerzeichen und der Tabulator.

public static String valueOf(boolean b)

Liefert den in einen String konvertierten Wert von b.

public static String valueOf(char c)

Liefert den in einen String konvertierten Wert von c.

public static String valueOf(int i)

Liefert den in einen String konvertierten Wert von i.

public static String valueOf(long l)

Liefert den in einen String konvertierten Wert von l.

public static String valueOf(float f)

Liefert den in einen String konvertierten Wert von f.

public static String valueOf(double d)

Liefert den in einen String konvertierten Wert von d.

public static String valueOf(char[] data)

Liefert einen neuen String, der die Zeichen aus data enthält. data wird hierzu in einen internen Puffer kopiert.

public static String valueOf(Object obj)

Liefert den String-Wert von obj zurück, der durch Aufruf von dessen toString-Methode ermittelt wird. Falls obj den Wert null hat, wird der String "null" zurückgegeben.

public static String valueOf(char[] data, int offset, int count)

Wie die vorangehende Variante, nur dass hier die ersten count Zeichen ab dem Index offset aus data verwendet werden.