模块  java.base
Paket java.lang

Klasse StringBuffer

  • Alle implementierten Schnittstellen
    Serializable ， Appendable ， CharSequence ， Comparable<StringBuffer> 
    public final class StringBuffer
extends Object
implements Serializable, Comparable<StringBuffer>, CharSequence
    Eine threadsichere, veränderbare Zeichenfolge. Ein String-Puffer ähneltString, ist aber veränderbar. Er enthält zu jedem Zeitpunkt eine bestimmte Zeichenfolge. Die Länge und der Inhalt dieser Folge lassen sich durch Methodenaufrufe ändern. Mehrere Threads können einen String-Puffer gemeinsam verwenden. Die Methoden werden bei Bedarf synchronisiert. Dadurch verhalten sich alle Operationen auf einer bestimmten Instanz so, als kämen sie in einer seriellen Reihenfolge vor. Diese Reihenfolge entspricht der Reihenfolge der Methodenaufrufe der einzelnen beteiligten Threads.

    StringBufferDie Hauptoperationen aufappend和insert-Methoden. Sie sind überladen und akzeptieren Daten beliebiger Typen. Jede Methode wandelt die gegebenen Daten effizient in einen String um. Danach hängt sie die Zeichen dieses Strings an den String-Puffer an oder fügt sie dort ein.appendDieinsertDie Methode fügt Zeichen an der angegebenen Position ein.

    Zum Beispiel: Wennzsich auf ein String-Buffer-Objekt bezieht, dessen aktueller Inhalt"start"ist, dann führt der Methodenaufrufz.append("le")dazu, dass der String-Buffer enthält"startle" , währendz.insert(4, "le")den String-Buffer so ändert, dass er enthält"starlet" 。

    Im Allgemeinen: Wenn sich sb auf eine Instanz beziehtStringBuffer ，然后sb.append(x)hat dieselbe Wirkungsb.insert(sb.length(), x) 。

    Bei jeder Operation an der Quellsequenz (zum Beispiel Anhängen oder Einfügen aus der Quellsequenz) synchronisiert diese Klasse nur den Zeichenketten-Puffer, auf dem die Operation ausgeführt wird, und nicht die Quelle. Beachten Sie, dassStringBufferzwar für die gleichzeitige Verwendung aus mehreren Threads ausgelegt ist, aber wenn der Konstruktor oderappendoder inserteine über Threads hinweg geteilte Quellsequenz übergeben wird, muss der aufrufende Code sicherstellen, dass die Quellsequenz während der Operation eine konsistente und unveränderliche Sicht bietet. Das ist erfüllt, wenn der Aufrufer während des Operationsaufrufs eine Sperre hält, eine unveränderliche Quellsequenz verwendet oder die Quellsequenz nicht über Threads hinweg teilt.

    Jeder Zeichenketten-Puffer hat eine Kapazität. Solange die Länge der im Zeichenketten-Puffer enthaltenen Zeichenfolge die Kapazität nicht überschreitet, ist kein neues internes Puffer-Array nötig. Läuft der interne Puffer über, wächst er automatisch.

    Sofern nicht anders angegeben, führt die Übergabe einesnull-Arguments annulleinen Konstruktor oder eine Methode in dazu, dass eine Ausnahme ausgelöst wirdNullPointerException。

    Ab der JDK-Version 5 enthält diese Klasse eine äquivalente Klasse für die Verwendung in einem einzelnen Thread.StringBuilder. Verwenden Sie in der Regel bevorzugt dieStringBuilder-Klasse, denn sie unterstützt dieselben Operationen und ist schneller, weil sie keine Synchronisation durchführt.

    API-Hinweis:
    StringBuffer实现Comparableüberschreibt aber nichtequals. Deshalb istStringBufferdie natürliche Reihenfolge von nicht konsistent mit equals. WennStringBufferObjekte alsStringBufferSchlüssel oder Elemente inSortedMap, SortedSet. SieheComparable,SortedMapoderSortedSetfür weitere Informationen. Seit Version: 1.0 Siehe auch:
    StringBuilder,String, Serialized Form

    • 构造方法摘要

      Konstruktor Beschreibung
      StringBuffer()
      Erzeugt einen String-Puffer ohne Zeichen mit einer Anfangskapazität von 16 Zeichen.
      StringBuffer​(int capacity)
      Erzeugt einen String-Puffer ohne Zeichen mit der angegebenen Anfangskapazität.
      StringBuffer​(CharSequence seq)
      Erzeugt einen String-Puffer, der dieselben Zeichen enthält wie dieCharSequenceangegebene Zeichenfolge.
      StringBuffer​(String str)
      Erzeugt einen String-Puffer, der mit dem Inhalt der angegebenen Zeichenfolge initialisiert wird.

    • 方法摘要

      Alle Methoden Instanzmethoden Konkrete Methoden Variablen und Typ Methode Beschreibung
      StringBuffer append​(boolean b)
      Hängt die String-Darstellung desbooleanParameters an die Sequenz an.
      StringBuffer append​(char c)
      Hängt die String-Darstellung descharParameters an diese Sequenz an.
      StringBuffer append​(char[] str)
      Hängt die String-Darstellung descharArrays-Parameters an diese Sequenz an.
      StringBuffer append​(char[] str, int offset, int len)
      Hängt die String-Darstellung des Unterarrays descharArrays-Parameters an diese Sequenz an.
      StringBuffer append​(double d)
      Hängt die String-Darstellung desdoubleParameters an diese Sequenz an.
      StringBuffer append​(float f)
      Hängt die String-Darstellung desfloatParameters an diese Sequenz an.
      StringBuffer append​(int i)
      Hängt die String-Darstellung desintParameters an diese Sequenz an.
      StringBuffer append​(long lng)
      Hängt die String-Darstellung deslongParameters an diese Sequenz an.
      StringBuffer append​(CharSequence s)
      Hängt die angegebeneCharSequence追加到此序列。
      StringBuffer append​(CharSequence s, int start, int end)
      Hängt die angegebeneCharSequenceSequenz an diese Sequenz an.
      StringBuffer append​(Object obj)
      Hängt die String-Darstellung desObjectParameters an.
      StringBuffer append​(String str)
      Hängt die angegebene Zeichenfolge an diese Zeichensequenz an.
      StringBuffer append​(StringBuffer sb)
      Hängt die angegebeneStringBuffer追加到此序列。
      StringBuffer appendCodePoint​(int codePoint)
      Hängt die String-Darstellung descodePointParameters an diese Sequenz an.
      int capacity()
      Gibt die aktuelle Kapazität zurück.
      char charAt​(int index)
      Gibt denchar值。
      IntStream chars()
      Gibt einen Stream zurück, der dieintWerte in dieser Sequenz charnull-erweitert.
      int codePointAt​(int index)
      Gibt das Zeichen (Unicode-Codepunkt) am angegebenen Index zurück.
      int codePointBefore​(int index)
      Gibt das Zeichen (Unicode-Codepunkt) vor dem angegebenen Index zurück.
      int codePointCount​(int beginIndex, int endIndex)
      Gibt die Anzahl der Unicode-Codepunkte im angegebenen Textbereich dieser Sequenz zurück.
      IntStream codePoints()
      Gibt einen Stream der Codepunktwerte dieser Sequenz zurück.
      int compareTo​(StringBuffer another)
      StringBufferVergleicht zwei StringBufferBeispiele in lexikografischer Reihenfolge.
      StringBuffer delete​(int start, int end)
      Entfernt Zeichen im Teilstring dieser Sequenz.
      StringBuffer deleteCharAt​(int index)
      Entfernt an dieser Position in dieser Reihenfolge das angegebenechar 。
      void ensureCapacity​(int minimumCapacity)
      Stellt sicher, dass die Kapazität mindestens dem angegebenen Minimalwert entspricht.
      void getChars​(int srcBegin, int srcEnd, char[] dst, int dstBegin)
      Kopiert Zeichen aus dieser Sequenz in das Ziel-Arraydst 。
      int indexOf​(String str)
      Gibt den Index des ersten Vorkommens des angegebenen Teilstrings im String zurück.
      int indexOf​(String str, int fromIndex)
      Gibt ab dem angegebenen Index den Index des ersten Vorkommens des angegebenen Teilstrings im String zurück.
      StringBuffer insert​(int offset, boolean b)
      Fügt die String-Darstellung des Parametersbooleanin diese Sequenz ein.
      StringBuffer insert​(int offset, char c)
      Fügt die String-Darstellung des Parameterscharin diese Sequenz ein.
      StringBuffer insert​(int offset, char[] str)
      Fügt die String-Darstellung descharArrays in diese Sequenz ein.
      StringBuffer insert​(int index, char[] str, int offset, int len)
      Fügt die String-Darstellung des Teilarrays desstrArrays in diese Sequenz ein.
      StringBuffer insert​(int offset, double d)
      Fügt die String-Darstellung des Parametersdoublein diese Sequenz ein.
      StringBuffer insert​(int offset, float f)
      Fügt die String-Darstellung des Parametersfloatin diese Sequenz ein.
      StringBuffer insert​(int offset, int i)
      Fügt die String-Darstellung des zweitenintParameters in diese Sequenz ein.
      StringBuffer insert​(int offset, long l)
      Fügt die String-Darstellung des Parameterslongin diese Sequenz ein.
      StringBuffer insert​(int dstOffset, CharSequence s)
      Fügt das angegebeneCharSequence插入此序列。
      StringBuffer insert​(int dstOffset, CharSequence s, int start, int end)
      Fügt die angegebeneCharSequenceSequenz in diese Sequenz ein.
      StringBuffer insert​(int offset, Object obj)
      Fügt die String-Darstellung des ParametersObjectin diese Zeichenfolge ein.
      StringBuffer insert​(int offset, String str)
      Fügt den String in diese Zeichenfolge ein.
      int lastIndexOf​(String str)
      Gibt den Index des letzten Vorkommens des angegebenen Teilstrings im String zurück.
      int lastIndexOf​(String str, int fromIndex)
      Gibt den Index des letzten Vorkommens des angegebenen Teilstrings im String zurück. Die Suche beginnt ab dem angegebenen Index rückwärts.
      int offsetByCodePoints​(int index, int codePointOffset)
      Gibt den Index in dieser Sequenz zurück. Dieser Index beginnt am angegebenenindexVersatz codePointOffsetCodepunkte.
      StringBuffer replace​(int start, int end, String str)
      Verwendet das angegebeneStringZeichen, um Zeichen in einem Teilstring dieser Sequenz zu ersetzen.
      StringBuffer reverse()
      Führt dazu, dass diese Zeichensequenz durch die Umkehrung der Sequenz ersetzt wird.
      void setCharAt​(int index, char ch)
      Setzt das Zeichen am angegebenen Index aufch 。
      void setLength​(int newLength)
      Setzt die Länge der Zeichensequenz.
      CharSequence subSequence​(int start, int end)
      Gibt eine neue Zeichensequenz zurück, die eine Teilsequenz dieser Sequenz ist.
      String substring​(int start)
      Gibt eine neueString zurück, die eine Teilsequenz der Zeichen enthält, die diese Zeichensequenz derzeit enthält.
      String substring​(int start, int end)
      Gibt eine neueString zurück, die eine Teilsequenz der Zeichen enthält, die diese Sequenz derzeit enthält.
      void trimToSize()
      Versucht, den Speicherplatz für die Zeichensequenz zu reduzieren.

    • 构造方法详细信息

      • StringBuffer

        public StringBuffer()
        Konstruiert einen Zeichenpuffer ohne Zeichen mit einer Anfangskapazität von 16 Zeichen.

      • StringBuffer

        public StringBuffer​(int capacity)
        Konstruiert einen Zeichenpuffer ohne Zeichen mit der angegebenen Anfangskapazität.
        Parameter
        capacity- Anfangskapazität. Ausnahme
        NegativeArraySizeException - 如果 capacityParameter kleiner als 0ist.

      • StringBuffer

        public StringBuffer​(String str)
        Konstruiert einen Zeichenpuffer, der mit dem Inhalt des angegebenen Strings initialisiert wird. Die Anfangskapazität des Zeichenpuffers ist16plus die Länge des String-Parameters.
        Parameter
        str- Anfangsinhalt des Puffers.

      • StringBuffer

        public StringBuffer​(CharSequence seq)
        Konstruiert einen Zeichenpuffer, der dieselben Zeichen wie die angegebeneCharSequenceenthält. Die Anfangskapazität des Zeichenpuffers ist16加上CharSequenceParameters. Wenn die Länge der angegebenen

        CharSequencekleiner oder gleich null ist, gibt der Konstruktor einen leeren Puffer mit der Kapazität16zurück.

        Parameter
        seq- Zu kopierende Sequenz. Seit Version: 1.5

    • 方法详细信息

      • compareTo

        public int compareTo​(StringBuffer another)
        StringBufferVergleicht zweiStringBufferBeispiele lexikografisch. Die Methode folgt denselben Regeln wie der lexikografische Vergleich in CharSequence.compare(this, another). Für feingranulare, gebietsschemaabhängige String-Vergleiche siehe

        Collator.

        Specified by:
        compareTo ，界面 Comparable<StringBuffer>
        Implementation Note: Diese Methode synchronisiert auf
        this (dem aktuellen Objekt), aber nicht auf this StringBuffer, während StringBuffer anothermit this StringBufferverglichen wird. Parameter
        another - StringBufferzu vergleichendes StringBuffer
        Rückgabewert
        0如果此StringBufferdieselbe Zeichenfolge wie der ParameterStringBufferenthält; wenn diesesStringBufferlexikografisch kleiner als derStringBuffer参数， StringBuffereine negative ganze Zahl; wenn diesesStringBufferlexikografisch größer als derStringBuffer参数， StringBuffereine positive ganze Zahl. Seit Version: 11

      • capacity

        public int capacity()
        Gibt die aktuelle Kapazität zurück. Die Kapazität ist der verfügbare Speicher für neu eingefügte Zeichen. Bei Überschreitung erfolgt eine neue Zuweisung.
        Rückgabewert Aktuelle Kapazität

      • ensureCapacity

        public void ensureCapacity​(int minimumCapacity)
        Stellt sicher, dass die Kapazität mindestens dem angegebenen Minimum entspricht. Ist die aktuelle Kapazität kleiner als der Parameter, wird ein neues internes Array mit größerer Kapazität zugewiesen. Die neue Kapazität ist das Maximum aus:
        • minimumCapacityParameter.
        • Dem Doppelten der alten Kapazität, plus2 。
        Wenn derminimumCapacityParameter nicht positiv ist, führt die Methode keine Aktion aus und kehrt zurück. Beachten Sie, dass nachfolgende Operationen an diesem Objekt die tatsächliche Kapazität unter den hier angeforderten Wert senken können.
        Parameter
        minimumCapacity- Die erforderliche Mindestkapazität.

      • trimToSize

        public void trimToSize()
        Versucht, den Speicher für die Zeichenfolge zu reduzieren. Ist der Puffer größer als für die aktuelle Zeichenfolge nötig, passt das Programm seine Größe an, um Platz zu sparen. Der Aufruf dieser Methode beeinflusst möglicherweise, aber nicht zwingend, den Wert, den nachfolgende Aufrufe der Methodecapacity()zurückgeben.
        Seit Version: 1.5

      • setLength

        public void setLength​(int newLength)
        Setzt die Länge der Zeichenfolge. Die Sequenz wird in eine neue Zeichenfolge geändert, deren Länge der Parameter angibt. Für jede nichtnegative Zahl knewLengthist das Zeichen an Index k der neuen Zeichenfolge identisch mit dem Zeichen an Index k der alten Sequenz, wenn k kleiner als die Länge der ursprünglichen Zeichenfolge ist. Andernfalls ist es das Nullzeichen'\u0000'. Mit anderen Worten, wennnewLengthder Parameter kleiner als die aktuelle Länge ist, wird die Länge auf den angegebenen Wert geändert. Wenn

        newLengthder Parameter größer oder gleich der aktuellen Länge ist, werden ausreichend Nullzeichen angehängt ( '\u0000' ), damit length demnewLength参数。

        newLength参数必须大于或等于0 。

        Parameter
        newLength- die neue Länge. Ausnahme
        IndexOutOfBoundsException - 如果 newLengthParameter negativ ist. Siehe auch:
        CharSequence.length()

      • charAt

        public char charAt​(int index)
        Gibt dencharWert dieser Sequenz am angegebenen Index zurück. Der erstecharWert befindet sich an Index0 , der nächste an Index1und so weiter, wie bei Array-Indizes. Der Parameter index muss größer oder gleich

        0sein und kleiner als die Länge dieser Sequenz.

        Wenn der durch den Index angegebenecharWert ein Surrogat ist, wird der Surrogatwert zurückgegeben.

        Specified by:
        charAtIn der Schnittstelle CharSequence
        Parameter
        index - der Index des benötigten charWerts. Ergebnis Der
        charWert am angegebenen Index. Ausnahme
        IndexOutOfBoundsException - 如果 index为负数或大于或等于 length()ist. Siehe auch:
        CharSequence.length()

      • codePointAt

        public int codePointAt​(int index)
        Gibt das Zeichen (Unicode-Codepunkt) am angegebenen Index zurück. Der Index bezieht sich aufcharWerte (Unicode-Codeeinheiten) im Bereich von0bisCharSequence.length() - 1. Wenn der am angegebenen Index befindliche

        charWert im Bereich hoher Surrogate liegt, der folgende Index kleiner als die Länge dieser Sequenz ist und dercharWert am folgenden Index im Bereich niedriger Surrogate liegt, wird der ergänzende Codepunkt zurückgegeben, der diesem Surrogatpaar entspricht. Andernfalls wird derchar值。

        Parameter
        index - charIndex des Wertes Ergebnis
        indexCodepunktwert des Zeichens an der Stelle Ausnahme
        IndexOutOfBoundsException - 如果 indexder Parameter negativ ist oder nicht kleiner als die Länge dieser Sequenz ist. Seit Version: 1.5

      • codePointBefore

        public int codePointBefore​(int index)
        Gibt das Zeichen (Unicode-Codepunkt) vor dem angegebenen Index zurück. Der Index bezieht sich aufcharWerte (Unicode-Codeeinheiten) im Bereich von1bisCharSequence.length(). Wenn

        char在值(index - 1)im unteren Surrogatbereich liegt, (index - 2)nicht negativ ist undchar在值(index - 2)im oberen Surrogatbereich liegt, gibt die Methode den ergänzenden Codepunktwert des Surrogatpaars zurück. Wennchar在值index - 1是未配对的低代理或一个高代理，则返回所述替代值。

        Parameter
        index- der Index nach dem Codepunkt, der zurückgegeben werden soll. Ergebnis Der Unicode-Codepunktwert vor dem angegebenen Index. Ausnahme
        IndexOutOfBoundsException - 如果 indexder Parameter kleiner als 1 oder größer als die Länge dieser Sequenz ist. Seit Version: 1.5

      • codePointCount

        public int codePointCount​(int beginIndex,
                          int endIndex)
        Gibt die Anzahl der Unicode-Codepunkte im angegebenen Textbereich dieser Sequenz zurück. Der Textbereich beginnt am angegebenenbeginIndex und erstreckt sich bischar在索引endIndex - 1. Die Länge des Textbereichs (inchar s) beträgt daherendIndex-beginIndex. Nicht gepaarte Surrogate in dieser Sequenz zählen als je ein Codepunkt.
        Parameter
        beginIndex - der Index des ersten chardes Textbereichs.
        endIndex - der Index nach dem letzten chardes Textbereichs. Ergebnis Die Anzahl der Unicode-Codepunkte im angegebenen Textbereich. Ausnahme
        IndexOutOfBoundsException - 如果 beginIndexnegativ ist oder endIndexgrößer als die Länge dieser Sequenz ist oder beginIndex大于 endIndexist. Seit Version: 1.5

      • offsetByCodePoints

        public int offsetByCodePoints​(int index,
                              int codePointOffset)
        Gibt den Index in dieser Sequenz zurück, der vom angegebenenindex偏移codePointOffsetals Codepunkte zählt.index和codePointOffsetUnpaarige Surrogate im angegebenen Textbereich zählen als jeweils ein Codepunkt.
        Parameter
        index- Der Index, der verschoben werden soll
        codePointOffset- Der Offset in Codepunkten Ergebnis Der Index in dieser Sequenz Ausnahmen
        IndexOutOfBoundsException - 如果 indexnegativ oder größer als die Länge dieser Sequenz ist, oder wenn codePointOffsetpositiv ist und die Teilsequenz ab indexweniger als codePointOffsetCodepunkte enthält, oder wenn codePointOffset ，或者 codePointOffsetweniger als den absoluten Betrag des absoluten Werts von indexCodepunkten enthält. index小于绝对值的绝对值 codePointOffset代码点。
        ist. Seit Version: 1.5

      • getChars

        public void getChars​(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)
        Kopiert Zeichen aus dieser Sequenz in das Ziel-Zeichenarraydst. Das erste zu kopierende Zeichen hat den IndexsrcBegin; das letzte zu kopierende Zeichen liegt am IndexsrcEnd-1. Die Gesamtzahl der zu kopierenden Zeichen beträgtsrcEnd-srcBegin. Die Zeichen werden in das Teilarray vondstkopiert, beginnend bei IndexdstBeginund endend bei Index:
           dstbegin + (srcEnd-srcBegin) - 1
        Parameter
        srcBegin- Beginnt das Kopieren bei diesem Offset.
        srcEnd- Stoppt das Kopieren bei diesem Offset.
        dst- Das Array, in das die Daten kopiert werden.
        dstBegin - Der Offset in dst. Ausnahmen
        IndexOutOfBoundsException- Wenn eine der folgenden Bedingungen erfüllt ist:
        • srcBegin是否定的
        • dstBegin是否定的
        • srcBeginder Parameter größer als dersrcEnd参数。
        • srcEnd大于this.length() 。
        • dstBegin+srcEnd-srcBegin大于dst.length

      • setCharAt

        public void setCharAt​(int index,
                      char ch)
        Setzt das Zeichen am angegebenen Index aufch. Die Sequenz wird geändert, um eine neue Zeichensequenz darzustellen. Diese ist identisch mit der ursprünglichen Sequenz, enthält aber das Zeichenchan der Positionindex. Der Parameter index muss größer oder gleich

        0sein und kleiner als die Länge dieser Sequenz.

        Parameter
        index- Der Index des zu ändernden Zeichens.
        ch- Das neue Zeichen. Ausnahme
        IndexOutOfBoundsException - 如果 index为负数或大于或等于 length(). Siehe auch:
        CharSequence.length()

      • append

        public StringBuffer append​(Object obj)
        Hängt dieObjectString-Darstellung des Parameters an. Der Gesamteffekt ist genau derselbe, als würde der Parameter durch die Methode

        String.valueOf(Object)in einen String konvertiert. Danach werden die Zeichen dieses Stringsappendedan diese Zeichensequenz angehängt.

        Parameter
        obj - Object. Rückgabewert Eine Referenz auf dieses Objekt.

      • append

        public StringBuffer append​(String str)
        Hängt den angegebenen String an diese Zeichensequenz an.

        StringDie Zeichen des Parameters werden der Reihe nach angehängt. Die Länge dieser Sequenz wächst um die Länge des Parameters. Wennstr是null ，则附加四个字符"null" 。

        Sei n die Länge dieser Zeichensequenz vor der Ausführung der Methodeappend. Wenn k kleiner als n ist, gilt: Das Zeichen am Index k in der neuen Sequenz entspricht dem Zeichen am Index k in der alten Sequenz. Andernfalls entspricht es dem Zeichen am Index k-n im Parameterstr.

        Parameter
        str- Ein String. Rückgabewert Eine Referenz auf dieses Objekt.

      • append

        public StringBuffer append​(StringBuffer sb)
        Hängt den angegebenenStringBufferan diese Sequenz an. Die Zeichen des

        StringBufferParameters werden der Reihe nach angehängt. Der Inhalt vonStringBuffer vergrößert die Länge vonStringBufferum die Länge des Parameters. Wennsb是null , werden die vier Zeichen"null"an diese Sequenz angehängtStringBuffer 。

        Sei n die Länge der alten Zeichenfolge, also die Länge der Zeichenfolge, die vor der Ausführung derappend方法之前StringBufferenthalten ist. Ist k kleiner als n, entspricht das Zeichen an Index k der neuen Zeichenfolge dem Zeichen an Index k der alten Zeichenfolge. Andernfalls entspricht es dem Zeichen an Index k-n des Argumentssb.

        Diese Methode synchronisiert auf dem Zielobjekt,this同步，但不在源上同步（ sb ）。

        Parameter
        sb - 要追加的 StringBuffer. Rückgabewert Eine Referenz auf dieses Objekt. Seit Version: 1.4

      • append

        public StringBuffer append​(CharSequence s)
        Hängt die angegebeneCharSequencean diese Sequenz an.

        CharSequenceDie Zeichen des Arguments werden der Reihe nach angehängt. Die Länge dieser Sequenz erhöht sich um die Länge des Arguments.

        Das Ergebnis dieser Methode entspricht exakt dem Aufruf von this.append(s, 0, s.length()).

        Diese Methode synchronisiert auf dem Zielobjekt,this同步，但不在源上同步（ s ）。

        Wenns是null ，则附加四个字符"null" 。

        Specified by:
        append接口 Appendable
        Parameter
        s - 要追加的 CharSequence. Rückgabewert Eine Referenz auf dieses Objekt. Seit Version: 1.5

      • append

        public StringBuffer append​(CharSequence s,
                           int start,
                           int end)
        Hängt die angegebeneCharSequenceSequenz an diese Sequenz an. Die

        startZeichen des Arguments ab Indexswerden der Reihe nach an den Inhalt dieser Sequenz angehängt, bis (ausschließlich) Indexend. Die Länge dieser Sequenz erhöht sich um den Wert vonend - start.

        Sei n die Länge dieser Zeichenfolge vor der Ausführung derappendMethode. Ist k kleiner als n, wird das Zeichen an Index k dieser Zeichenfolge gleich dem Zeichen an Index k dieser Sequenz. Andernfalls wird es gleich demsan Index k + start-n des Argumentss 。

        Wenns是null , hängt diese Methode Zeichen an, als wäre der Parameter s eine Sequenz mit vier Zeichen"null"的序列"null" 。

        Specified by:
        append在接口 Appendable
        Parameter
        s- Die anzuhängende Sequenz.
        start- Der Startindex der anzuhängenden Teilsequenz.
        end- Der Endindex der anzuhängenden Teilsequenz. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        IndexOutOfBoundsException - 如果 start为负数，或 start大于 endoder end大于 s.length()
        Verfügbar ab Version: 1.5

      • append

        public StringBuffer append​(char[] str)
        Hängt diecharString-Darstellung des Array-Parameters an diese Sequenz an. Die Zeichen des Array-Parameters werden in Reihenfolge an den Inhalt dieser Sequenz angehängt. Die Länge dieser Sequenz erhöht sich um die Länge des Parameters.

        Der Gesamteffekt ist, als würde der Parameter durch die MethodeString.valueOf(char[])in einen String umgewandelt, und die Zeichen dieses Strings werden danachappendedan diese Zeichensequenz angehängt.

        Parameter
        str- Die anzuhängenden Zeichen. Rückgabewert Eine Referenz auf dieses Objekt.

      • append

        public StringBuffer append​(char[] str,
                           int offset,
                           int len)
        Hängt diecharString-Darstellung des Teilarrays des Array-Parameters an diese Sequenz an. Die

        offset开始的char阵列strwerden in Reihenfolge an den Inhalt dieser Sequenz angehängt. Die Länge dieser Sequenz erhöht sich um den Wertlen 。

        Der Gesamteffekt ist, als würde der Parameter durch die MethodeString.valueOf(char[],int,int)in einen String umgewandelt, und die Zeichen dieses Strings werden danachappendedan diese Zeichensequenz angehängt.

        Parameter
        str- Die anzuhängenden Zeichen.
        offset - Der Index des ersten char, das angehängt wird.
        len - 要追加的 chars, die angehängt werden. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        IndexOutOfBoundsException - Wenn das Argument offset < 0oder len < 0oder offset+len > str.length

      • append

        public StringBuffer append​(boolean b)
        ist, hängt die Methode diebooleanString-Darstellung des Arguments an die Sequenz an. Der Gesamteffekt ist genau derselbe wie bei der Konvertierung des Arguments in einen String durch die Methode

        String.valueOf(boolean), und die Zeichen dieses Strings werden anschließendappendedan diese Zeichenfolge angehängt.

        Parameter
        b - a boolean. Rückgabewert Eine Referenz auf dieses Objekt.

      • append

        public StringBuffer append​(char c)
        hängt diecharString-Darstellung des Arguments an diese Sequenz an. Das Argument wird an den Inhalt dieser Sequenz angehängt. Die Länge dieser Sequenz erhöht sich um

        1 。

        Der Gesamteffekt ist genau derselbe wie bei der MethodeString.valueOf(char), die das Argument in einen String konvertiert. Danach werden die Zeichen dieses Stringsappendedangehängt.

        Specified by:
        append在接口 Appendable
        Parameter
        c - a char. Rückgabewert Eine Referenz auf dieses Objekt.

      • append

        public StringBuffer append​(int i)
        hängt dieintString-Darstellung des Arguments an diese Sequenz an. Der Gesamteffekt ist so, als würde das Argument durch die Methode

        String.valueOf(int)in einen String konvertiert, und die Zeichen dieses Strings werden anschließendappendedan diese Zeichenfolge angehängt.

        Parameter
        i - int. Rückgabewert Eine Referenz auf dieses Objekt.

      • appendCodePoint

        public StringBuffer appendCodePoint​(int codePoint)
        hängt diecodePointString-Darstellung des Arguments an diese Sequenz an. Das Argument wird an den Inhalt dieser Sequenz angehängt. Die Länge der Sequenz erhöht sich um

        Character.charCount(codePoint).

        Der Gesamteffekt ist genau derselbe wie bei der Konvertierung des Arguments in einCharacter.toChars(int)将参数转换为char, und die Zeichen dieses Arrays werden anschließendappendedan diese Zeichenfolge angehängt.

        Parameter
        codePoint- Unicode-Codepunkt Ergebnis Eine Referenz auf dieses Objekt. Seit Version: 1.5

      • append

        public StringBuffer append​(long lng)
        Hängt dielongString-Darstellung des Arguments an diese Sequenz an. Der Gesamteffekt ist genau derselbe wie beim

        String.valueOf(long)Umwandeln des Arguments in einen String mit der Methode. Danach sind die Zeichen dieses Strings Teil dieser Zeichensequenzappended.

        Parameter
        lng - a long. Ergebnis Eine Referenz auf dieses Objekt.

      • append

        public StringBuffer append​(float f)
        Hängt diefloatString-Darstellung des Arguments an diese Sequenz an. Der Gesamteffekt ist genau derselbe wie beim

        String.valueOf(float)Umwandeln des Arguments in einen String mit der Methode. Danach sind die Zeichen dieses Strings Teil dieser Zeichensequenzappended.

        Parameter
        f - a float. Ergebnis Eine Referenz auf dieses Objekt.

      • append

        public StringBuffer append​(double d)
        Hängt diedoubleString-Darstellung des Arguments an diese Sequenz an. Der Gesamteffekt ist genau derselbe wie bei der Methode

        String.valueOf(double)zum Umwandeln des Arguments in einen String. Danach sind die Zeichen dieses Stringsappended.

        Parameter
        d - a double. Ergebnis Eine Referenz auf dieses Objekt.

      • delete

        public StringBuffer delete​(int start,
                           int end)
        Entfernt die Zeichen in einem Teilstring dieser Sequenz. Der Teilstring beginnt am angegebenenstartIndex. Er erstreckt sich bis zum Zeichen am Index oder bis zum Ende der Sequenz, falls ein solches Zeichen nicht existiert. Wennend - 1gleichstart等于end ，则不进行任何更改。
        Parameter
        start- Startindex, einschließlich.
        end- Endindex, ausschließlich. Ergebnis Dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException - 如果 start为负数，大于 length() ，或大于 endist. Seit Version: 1.2

      • deleteCharAt

        public StringBuffer deleteCharAt​(int index)
        Entfernt das Zeichen an der angegebenen Position in dieser Sequenz.char。 Diese Sequenz wird um einencharverkürzt. Hinweis: Wenn das Zeichen am angegebenen Index ein ergänzendes Zeichen ist, löscht diese Methode nicht das gesamte Zeichen. Wenn Sie ergänzende Zeichen genau verarbeiten müssen, bestimmen Sie die Anzahl

        chardurch Aufruf vonCharacter.charCount(thisSequence.codePointAt(index)) ，其中thisSequencefür diese Sequenz.

        Parameter
        index - Zu löschender Index char
        Rückgabewert Dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException - 如果 index为负数或大于或等于 length()ist. Seit Version: 1.2

      • replace

        public StringBuffer replace​(int start,
                            int end,
                            String str)
        Ersetzt die Zeichen in einer Teilzeichenkette dieser Sequenz durch die Zeichen des angegebenenString. Die Teilzeichenkette beginnt am angegebenenstartund erstreckt sich bis zum Zeichen am Indexend - 1oder bis zum Ende der Sequenz, falls ein solches Zeichen nicht existiert. Zuerst werden die Zeichen in der Teilzeichenkette gelöscht, dann wird der angegebeneStringeingefügtstart. (Bei Bedarf wird diese Sequenz verlängert, um die angegebene Zeichenkette aufzunehmen.)
        Parameter
        start- Startindex, einschließlich.
        end- Endindex, ausschließlich.
        str- Zeichenkette, die den bisherigen Inhalt ersetzt. Rückgabewert Dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException - 如果 start为负数，大于 length() ，或大于 endist. Seit Version: 1.2

      • substring

        public String substring​(int start)
        Gibt eine neueStringzurück, die eine Teilsequenz der aktuell in dieser Zeichenfolge enthaltenen Zeichen enthält. Die Teilzeichenkette beginnt am angegebenen Index und erstreckt sich bis zum Ende dieser Sequenz.
        Parameter
        start- Startindex, einschließlich. Rückgabewert Die neue Zeichenkette. Ausnahme
        StringIndexOutOfBoundsException - 如果 startkleiner als null oder größer als die Länge dieses Objekts ist. Seit Version: 1.2

      • subSequence

        public CharSequence subSequence​(int start,
                                int end)
        Gibt eine neue Zeichenfolge zurück, die eine Teilsequenz dieser Sequenz ist. Der Aufruf dieser Methode in der Form

           sb.subSequence(begin,&nbsp;end)
        verhält sich genau wie der Aufruf von
           sb.substring(begin,&nbsp;end)
        Diese Methode wird bereitgestellt, damit diese Klasse dasCharSequenceInterface implementieren kann.
        Specified by:
        subSequence ，界面 CharSequence
        Parameter
        start- Startindex, einschließlich.
        end- Endindex, exklusiv. Ergebnis Die angegebene Teilsequenz. Ausnahme
        IndexOutOfBoundsException - 如果 startoder endnegativ ist, wenn end大于 length() ，或者 start大于 end
        ist. Seit Version: 1.4

      • substring

        public String substring​(int start,
                        int end)
        Gibt ein neuesStringzurück, das eine Teilsequenz der Zeichen enthält, die sich aktuell in dieser Sequenz befinden. Die Teilzeichenkette beginnt am angegebenenstartund erstreckt sich bis zum Zeichen am Indexend - 1.
        Parameter
        start- Startindex, einschließlich.
        end- Endindex, exklusiv. Ergebnis Der neue String. Ausnahme
        StringIndexOutOfBoundsException - 如果 startoder end为负数或大于 length() ，或 start大于 endist. Seit Version: 1.2

      • insert

        public StringBuffer insert​(int index,
                           char[] str,
                           int offset,
                           int len)
        Fügt die String-Darstellung eines Teilarrays desstrArrays in diese Sequenz ein. Das Teilarray beginnt am angegebenenoffsetund erstreckt sich bislen chars. Die Zeichen des Teilarrays werden an der durchindexangegebenen Position in diese Sequenz eingefügt. Die Länge dieser Sequenz erhöht sich umlen chars.
        Parameter
        index- Die Position, an der das Teilarray eingefügt wird.
        str - Ein char-Array.
        offset - Der Index des ersten charim Teilarray, das eingefügt wird.
        len - Die Anzahl der chars im Teilarray, das eingefügt wird. Ergebnis Dieses Objekt Ausnahme
        StringIndexOutOfBoundsException - 如果 index为负数或大于 length() ，或 offsetoder len为负数，或 (offset+len)大于 str.length. Verfügbar ab Version: 1.2

      • insert

        public StringBuffer insert​(int offset,
                           Object obj)
        Fügt die Zeichenfolgendarstellung des ParametersObjectin diese Zeichenfolge ein. Das Ergebnis ist identisch mit der Methode

        String.valueOf(Object)die das zweite Argument in einen String umwandelt. Danach werden die Zeichen dieses Strings am angegebenen Offset in die Zeichenfolge eingefügt.inserted。

        offset参数必须大于或等于0sein und kleiner oder gleich der length dieser Sequenz.

        Parameter
        offset- Der Offset.
        obj - Object. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- Wenn der Offset ungültig ist.

      • insert

        public StringBuffer insert​(int offset,
                           String str)
        Fügt einen String in diese Zeichenfolge ein.

        StringDie Zeichen des Parameters werden in dieser Sequenz am angegebenen Offset eingefügt. Dabei verschiebt die Methode alle Zeichen nach oben, die sich ursprünglich an dieser Position befinden, und erhöht die Länge der Sequenz um die Länge des Parameters. Wennstr是null ，则将四个字符"null"in die Sequenz eingefügt.

        Das Zeichen am Index k in der neuen Zeichenfolge entspricht:

        • Wenn k kleiner istoffset, dann ist das Zeichen am Index k in der alten Zeichenfolge
        • ParameterstrIndex ist k-offsetZeichen, wenn k nicht kleiner alsoffset但小于offset+str.length()
        • das Zeichen mit dem Index k in der alten Zeichenfolge,-str.length()wenn k nicht kleiner ist.offset+str.length()

        offset参数必须大于或等于0und kleiner oder gleich dem length dieser Sequenz sein.

        Parameter
        offset- Der Offset.
        str- Eine Zeichenfolge. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- Wenn der Offset ungültig ist.

      • insert

        public StringBuffer insert​(int offset,
                           char[] str)
        Fügt diecharString-Darstellung des Array-Parameters in diese Sequenz ein. Die Zeichen des Array-Parameters werden an der

        offsetangegebenen Position in den Inhalt dieser Sequenz eingefügt. Die Länge der Sequenz erhöht sich um die Länge des Parameters.

        Die Gesamtwirkung ist genau dieselbe, als würde der zweite Parameter durch die MethodeString.valueOf(char[])in einen String umgewandelt. Danach gehen die Zeichen dieses Strings an den angegebenen Offsets in diese Zeichensequenzinsertedüber.

        offset参数必须大于或等于0sein und kleiner oder gleich der Länge dieser Sequenz.

        Parameter
        offset- Der Offset.
        str- Das Zeichenarray. Ergebnis Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- Wenn der Offset ungültig ist.

      • insert

        public StringBuffer insert​(int dstOffset,
                           CharSequence s)
        Fügt den angegebenenCharSequencein diese Sequenz ein.

        CharSequenceDie Zeichen des Parameters werden in der angegebenen Reihenfolge an den angegebenen Offset in diese Sequenz eingefügt. Dabei werden alle Zeichen, die sich ursprünglich an dieser Position oder darüber befanden, nach oben verschoben. Die Länge der Sequenz erhöht sich um die Länge des Parameters.

        Das Ergebnis dieser Methode ist genau dasselbe wie der Aufruf der Methodeinsert(dstOffset, s, 0, s.length()) dieses Objekts.

        Wenn der Parameters是null ，则将四个字符"null"in diese Sequenz eingefügt.

        Parameter
        dstOffset- Der Offset.
        s- Die einzufügende Sequenz. Ergebnis Eine Referenz auf dieses Objekt. Ausnahme
        IndexOutOfBoundsException- Wenn der Offset ungültig ist. Seit Version: 1.5

      • insert

        public StringBuffer insert​(int dstOffset,
                           CharSequence s,
                           int start,
                           int end)
        Fügt die angegebeneCharSequenceSequenz in diese Sequenz ein. Die Teilsequenz des Parameters

        swird durch die Angabe vonstart和endeingefügt. Sie landet am angegebenen Ziel-Offset in dieser Sequenz. Dabei werden alle Zeichen, die sich ursprünglich an dieser Position oder darüber befanden, nach oben verschoben. Die Länge der Sequenz erhöht sich umend - start 。

        Das Zeichen am Index k in dieser Sequenz wird gleich:

        • wenn k kleiner alsdstOffsetist, dem Zeichen am Index k in dieser Sequenz
        • Parametersdem Zeichen am Index k+start-dstOffsetim Parameter, wenn k größer oder gleichdstOffset但小于dstOffset+end-start
        • Wenn k größer oder gleichdstOffset+end-startist, ist das Zeichen an der Position k-(end-start)in dieser Sequenz

        dstOffset参数必须大于或等于0sein und kleiner oder gleich dem length dieser Sequenz.

        Der Parameter start muss nichtnegativ sein und darf nicht größerend 。

        Der Parameter end muss größer oder gleichstartsein und kleiner oder gleich der Länge von s.

        Wenns是null , fügt diese Methode die Zeichen ein, als wäre der Parameter s eine Sequenz mit vier Zeichen"null"的序列"null" 。

        Parameter
        dstOffset- Der Versatz in dieser Sequenz.
        s- Die einzufügende Sequenz.
        start- Der Startindex der einzufügenden Teilsequenz.
        end- Der Endindex der einzufügenden Teilsequenz. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahmen
        IndexOutOfBoundsException - 如果 dstOffset为负数或大于 this.length() ，或 startoder end为负数，或 start大于 endoder end大于 s.length()
        从以下版本开始：
        1.5

      • insert

        public StringBuffer insert​(int offset,
                           boolean b)
        FügtbooleanDie Zeichenfolgendarstellung des Parameters wird in diese Sequenz eingefügt. Der Gesamteffekt ist identisch mit dem Aufruf der Methode

        String.valueOf(boolean)zur Umwandlung des zweiten Parameters in eine Zeichenfolge. Danach gehen die Zeichen dieser Zeichenfolge an der angegebenen Position in die Zeichensequenzinsertedüber.

        offset参数必须大于或等于0und kleiner oder gleich der length dieser Sequenz sein.

        Parameter
        offset- Die Position.
        b - a boolean. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- Wenn die Position ungültig ist.

      • insert

        public StringBuffer insert​(int offset,
                           char c)
        Fügt diecharString-Darstellung des Parameters in diese Sequenz ein. Der Gesamteffekt ist genau derselbe wie bei der Methode

        String.valueOf(char)das zweite Argument in einen String umzuwandeln, und dann gehen die Zeichen dieses Strings an den angegebenen Offset in die Zeichensequenzinserted.

        offset参数必须大于或等于0sein und kleiner oder gleich der length dieser Sequenz.

        Parameter
        offset- Offset.
        c - a char. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        IndexOutOfBoundsException- wenn der Offset ungültig ist.

      • insert

        public StringBuffer insert​(int offset,
                           int i)
        Fügt die String-Darstellung des zweitenintParameters in diese Sequenz ein. Der Gesamteffekt ist genau derselbe wie bei der Methode

        String.valueOf(int)das zweite Argument in einen String umzuwandeln, und dann gehen die Zeichen dieses Strings an den angegebenen Offset in die Zeichensequenzinserted.

        offset参数必须大于或等于0sein und kleiner oder gleich der length dieser Sequenz.

        Parameter
        offset- Offset.
        i - int. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- wenn der Offset ungültig ist.

      • insert

        public StringBuffer insert​(int offset,
                           long l)
        Fügt dielongString-Darstellung des Parameters in diese Sequenz ein. Der Gesamteffekt ist genau derselbe wie bei der Methode

        String.valueOf(long)das zweite Argument in einen String umzuwandeln, und dann gehen die Zeichen dieses Strings an den angegebenen Offset in die Zeichensequenzinserted.

        offset参数必须大于或等于0sein und kleiner oder gleich der length dieser Sequenz.

        Parameter
        offset- Offset.
        l - a long. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- wenn der Offset ungültig ist.

      • insert

        public StringBuffer insert​(int offset,
                           float f)
        Fügt diefloatString-Darstellung des Parameters in diese Sequenz ein. Der Gesamteffekt ist genau derselbe wie bei der Methode

        String.valueOf(float)das zweite Argument in einen String umzuwandeln, und dann gehen die Zeichen dieses Strings an den angegebenen Offset in die Zeichensequenzinserted。

        offset参数必须大于或等于0sein und kleiner oder gleich der length dieser Sequenz.

        Parameter
        offset- Offset.
        f - a float. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- wenn der Offset ungültig ist.

      • insert

        public StringBuffer insert​(int offset,
                           double d)
        Fügt diedoubleString-Darstellung des Parameters in diese Sequenz ein. Das Ergebnis ist identisch mit dem Aufruf der Methode

        String.valueOf(double), die den zweiten Parameter in einen String umwandelt. Danach gehen die Zeichen dieses Strings am angegebenen Offset in die Zeichenfolgeinsertedein.

        offset参数必须大于或等于0sein und kleiner oder gleich der length dieser Sequenz.

        Parameter
        offset- Offset.
        d - a double. Rückgabewert Eine Referenz auf dieses Objekt. Ausnahme
        StringIndexOutOfBoundsException- wenn der Offset ungültig ist.

      • indexOf

        public int indexOf​(String str)
        Gibt den Index des ersten Vorkommens des angegebenen Teilstrings im String zurück. Der zurückgegebene Index ist der kleinste Wert

        k ，其中： 

           this.toString().startsWith(str, k)
        Wenn kein solcher Wertk存在，那么-1返回。
        Parameter
        str- der zu suchende Teilstring. Rückgabewert Der Index des ersten Vorkommens des angegebenen Teilstrings, wenn kein solcher Fall vorliegt,
        -1. Seit Version: 1.4

      • indexOf

        public int indexOf​(String str,
                   int fromIndex)
        Gibt ab dem angegebenen Index den Index des ersten Vorkommens des angegebenen Teilstrings im String zurück. Der zurückgegebene Index ist der kleinste Wert

        k ，其中： 

           k >= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)
        Wenn kein solcher Wertk存在，那么-1返回。
        Parameter
        str- der zu suchende Teilstring.
        fromIndex- der Index, ab dem die Suche beginnt. Rückgabewert Der Index des ersten Vorkommens des angegebenen Teilstrings ab dem angegebenen Index, wenn kein solcher Fall vorliegt
        -1. Seit Version: 1.4

      • lastIndexOf

        public int lastIndexOf​(String str)
        Gibt den Index des letzten Vorkommens des angegebenen Teilstrings in der Zeichenkette zurück. Das letzte Auftreten des leeren Strings "" gilt als am Indexwertthis.length(). Der zurückgegebene Index ist der größte Wert

        k ，其中： 

           this.toString().startsWith(str, k)
        Wenn kein solcher Wertk存在，那么-1返回。
        Parameter
        str- Der zu suchende Teilstring. Ergebnis Der Index des letzten Vorkommens des angegebenen Teilstrings. Wenn dies nicht der Fall ist,
        -1. Seit Version: 1.4

      • lastIndexOf

        public int lastIndexOf​(String str,
                       int fromIndex)
        Gibt den Index des letzten Vorkommens des angegebenen Teilstrings in der Zeichenkette zurück. Die Suche beginnt am angegebenen Index und läuft rückwärts. Der zurückgegebene Index ist der größte Wert

        k ，其中： 

           k <= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)
        Wenn kein solcher Wertk存在，那么-1返回。
        Parameter
        str- Der zu suchende Teilstring.
        fromIndex- Der Index, ab dem die Suche rückwärts startet. Ergebnis Der Index des letzten Vorkommens des angegebenen Teilstrings bei rückwärts laufender Suche ab dem angegebenen Index. Wenn dies nicht der Fall ist,
        -1Suche. Seit Version: 1.4

      • reverse

        public StringBuffer reverse()
        Bewirkt, dass diese Zeichenfolge durch ihre Umkehrung ersetzt wird. Enthält die Folge Surrogatpaare, werden diese als einzelne Zeichen behandelt. Die Reihenfolge von High- und Low-Surrogaten wird daher nie umgekehrt. Sei n die Zeichenlänge dieser Zeichenfolge vor der Ausführung derreverseMethode (nicht die Länge imcharWert). Dann gilt: Das Zeichen an Index k in der neuen Zeichenfolge entspricht dem Zeichen an Index n-k-1 in der alten Zeichenfolge. Beachten Sie, dass die Umkehrung Surrogatpaare erzeugen kann. Diese Paare bestanden vorher aus unpaarigen Low- und High-Surrogaten. Zum Beispiel erzeugt die Umkehrung von "\uDC00\uD800" den Wert "\uD800\uDC00". Dies ist ein gültiges Surrogatpaar.

        Ergebnis Eine Referenz auf dieses Objekt. Seit Version: 1.0.2

      • chars

        public IntStream chars()
        Gibt einenint-Stream zurück, der diecharWerte dieser Sequenz null-erweitert. Jedes Zeichen, das einem surrogate code point zugeordnet ist, bleibt uninterpretiert. Der Stream wird beim Start der terminalen Stream-Operation an die Sequenz gebunden (bei veränderlichen Sequenzen ist der Spliterator late-binding). Wird die Sequenz während der Operation geändert, ist das Ergebnis undefiniert.

        Specified by:
        chars在接口 CharSequence
        Ergebnis Ein IntStream der char-Werte dieser Sequenz. Seit Version: 9

      • codePoints

        public IntStream codePoints()
        Gibt einen Stream der Codepunktwerte dieser Sequenz zurück. Alle Surrogatpaare in der Sequenz werden kombiniert, wie bei Character.toCodePoint. Das Ergebnis wird an den Stream übergeben. Alle anderen Codeeinheiten, einschließlich normaler BMP-Zeichen, unpaariger Surrogate und undefinierter Codeeinheiten, werden null-erweitert zuintWerten und an den Stream übergeben. Der Stream wird beim Start der terminalen Stream-Operation an die Sequenz gebunden (bei veränderlichen Sequenzen ist der Spliterator late-binding). Wird die Sequenz während der Operation geändert, ist das Ergebnis undefiniert.

        Specified by:
        codePointsIn CharSequence
        Ergebnis Ein IntStream der Unicode-Codepunkte dieser Sequenz. Seit Version: 9