模块  java.base
Paquetage java.lang

Class StringBuffer

  • Toutes les interfaces implémentées
    Serializable , Appendable , CharSequence , Comparable<StringBuffer>

    public final class StringBuffer
    extends Object
    implements Serializable, Comparable<StringBuffer>, CharSequence
    Séquence de caractères mutable et thread-safe. Un tampon de chaînes ressemble àStringmais il est modifiable. À tout instant, il contient une séquence de caractères précise. La longueur et le contenu de cette séquence changent via certains appels de méthodes. Plusieurs threads peuvent utiliser un tampon de chaînes. Ces méthodes se synchronisent au besoin. Ainsi, toutes les opérations sur une instance donnée se comportent comme si elles suivaient un ordre sériel. Cet ordre correspond à l'ordre des appels de méthodes de chaque thread concerné.

    StringBufferLes opérations principales surappend和insertetappend方法总是在缓冲区的末尾添加这些字符; insertLa méthode ajoute des caractères au point spécifié.

    Par exemple, sizelle fait référence à un objet tampon de chaîne dont le contenu actuel est"start", alors l'appel de la méthodez.append("le")provoque l'ajout au tampon de chaîne du contenu"startle" , tandis quez.insert(4, "le")elle modifie le tampon de chaîne pour qu'il contienne"starlet" 。

    En général, si une personne fait référence à une instanceStringBuffer ,然后sb.append(x)a le même effet quesb.insert(sb.length(), x) 。

    Cette classe se synchronise uniquement sur le tampon de chaîne qui exécute l'opération. Elle ne se synchronise pas sur la source. Cela s'applique à chaque opération impliquant la séquence source, comme un ajout ou une insertion depuis celle-ci.StringBuffercette classe soit conçue pour être utilisée simultanément par plusieurs threads en toute sécurité, si le constructeur ouappend或insertune opération reçoit une séquence source partagée entre threads, le code appelant doit garantir que l'opération dispose d'une vue cohérente et immuable de la séquence source pendant sa durée. Pour cela, l'appelant détient un verrou pendant l'appel de l'opération, utilise une séquence source immuable, ou ne partage pas la séquence source entre threads.

    Chaque tampon de chaîne possède une capacité. Tant que la longueur de la séquence de caractères contenue dans le tampon de chaîne ne dépasse pas la capacité, il n'est pas nécessaire d'allouer un nouveau tableau interne. Si le tampon interne déborde, il s'agrandit automatiquement.

    Sauf mention contraire, passer unnullargumentnullà un constructeur ou à une méthode deNullPointerExceptionprovoque la levée d'une exception

    .StringBuilderDepuis le JDK 5, cette classe a été complétée par une classe équivalente conçue pour un seul thread,StringBuilder. En général, la classe

    est préférée, car elle prend en charge toutes les mêmes opérations, mais elle est plus rapide, car elle n'effectue pas de synchronisation.
    StringBuffer实现ComparableL'implémentationequalsne redéfinit pasStringBuffer. Par conséquent,StringBufferl'ordre naturel deStringBuffern'est pas cohérent avec equals. Si des objetsSortedMapsont utilisés comme clés dans SortedSetou comme éléments dansComparable,SortedMap. VoirSortedSetpour plus d'informations. Depuis la version : 1.0 Voir aussi :
    StringBuilder,String, Serialized Form
    • 构造方法摘要

      Constructeur Description
      StringBuffer()
      Construit un tampon de chaîne sans caractères, avec une capacité initiale de 16 caractères.
      StringBuffer​(int capacity)
      Construit un tampon de chaîne sans caractères, avec la capacité initiale spécifiée.
      StringBuffer​(CharSequence seq)
      Construit un tampon de chaîne contenant les mêmes caractères que laCharSequencechaîne spécifiée.
      StringBuffer​(String str)
      Construit un tampon de chaîne initialisé avec le contenu de la chaîne spécifiée.
    • 方法摘要

      Toutes les méthodes Méthodes d'instance Méthodes concrètes Variables et types Méthode Description
      StringBuffer append​(boolean b)
      Ajoute la représentation sous forme de chaîne de l'argumentbooleanà la séquence.
      StringBuffer append​(char c)
      Ajoute la représentation sous forme de chaîne de l'argumentcharà cette séquence.
      StringBuffer append​(char[] str)
      Ajoute la représentation sous forme de chaîne de l'argumentchartableau à cette séquence.
      StringBuffer append​(char[] str, int offset, int len)
      Ajoute la représentation sous forme de chaîne du sous-tableau de l'argumentchartableau à cette séquence.
      StringBuffer append​(double d)
      Ajoute la représentation sous forme de chaîne de l'argumentdoubleà cette séquence.
      StringBuffer append​(float f)
      Ajoute la représentation sous forme de chaîne de l'argumentfloatà cette séquence.
      StringBuffer append​(int i)
      Ajoute la représentation sous forme de chaîne de l'argumentintà cette séquence.
      StringBuffer append​(long lng)
      Ajoute la représentation sous forme de chaîne de l'argumentlongà cette séquence.
      StringBuffer append​(CharSequence s)
      Ajoute leCharSequence追加到此序列。
      StringBuffer append​(CharSequence s, int start, int end)
      Ajoute laCharSequenceséquence spécifiée à cette séquence.
      StringBuffer append​(Object obj)
      Ajoute la représentation sous forme de chaîne de l'argumentObject.
      StringBuffer append​(String str)
      Ajoute la chaîne spécifiée à cette séquence de caractères.
      StringBuffer append​(StringBuffer sb)
      Ajoute leStringBuffer追加到此序列。
      StringBuffer appendCodePoint​(int codePoint)
      Ajoute la représentation sous forme de chaîne de l'argumentcodePointà cette séquence.
      int capacity()
      Retourne la capacité actuelle.
      char charAt​(int index)
      Retourne la valeurchar值。
      IntStream chars()
      Retourne un flux deintavec extension zéro sur les valeurs charde cette séquence.
      int codePointAt​(int index)
      Retourne le caractère (point de code Unicode) à l'index spécifié.
      int codePointBefore​(int index)
      Retourne le caractère (point de code Unicode) avant l'index spécifié.
      int codePointCount​(int beginIndex, int endIndex)
      Retourne le nombre de points de code Unicode dans la plage de texte spécifiée de cette séquence.
      IntStream codePoints()
      Retourne un flux des valeurs de points de code de cette séquence.
      int compareTo​(StringBuffer another)
      StringBufferCompare deux instances dans l'ordre StringBufferlexicographique.
      StringBuffer delete​(int start, int end)
      Supprime les caractères dans une sous-chaîne de cette séquence.
      StringBuffer deleteCharAt​(int index)
      Supprime le caractère à la position spécifiée dans cetchar 。
      void ensureCapacity​(int minimumCapacity)
      Garantit une capacité au moins égale au minimum spécifié.
      void getChars​(int srcBegin, int srcEnd, char[] dst, int dstBegin)
      Copie les caractères de cette séquence vers le tableau de caractères cibledst 。
      int indexOf​(String str)
      Retourne l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne.
      int indexOf​(String str, int fromIndex)
      Retourne l'index de la première occurrence de la sous-chaîne spécifiée, à partir de l'index donné.
      StringBuffer insert​(int offset, boolean b)
      Insère la représentation sous forme de chaîne de l'argumentbooleandans cette séquence.
      StringBuffer insert​(int offset, char c)
      Insère la représentation sous forme de chaîne de l'argumentchardans cette séquence.
      StringBuffer insert​(int offset, char[] str)
      Insère la représentation sous forme de chaîne de l'argumentchartableau dans cette séquence.
      StringBuffer insert​(int index, char[] str, int offset, int len)
      Insère la représentation sous forme de chaîne du sous-tableau de l'argumentstrtableau dans cette séquence.
      StringBuffer insert​(int offset, double d)
      Insère la représentation sous forme de chaîne de l'argumentdoubledans cette séquence.
      StringBuffer insert​(int offset, float f)
      Insère la représentation sous forme de chaîne de l'argumentfloatdans cette séquence.
      StringBuffer insert​(int offset, int i)
      Insère la représentation sous forme de chaîne du secondintargument dans cette séquence.
      StringBuffer insert​(int offset, long l)
      Insère la représentation sous forme de chaîne de l'argumentlongdans cette séquence.
      StringBuffer insert​(int dstOffset, CharSequence s)
      Insère leCharSequence插入此序列。
      StringBuffer insert​(int dstOffset, CharSequence s, int start, int end)
      Insère laCharSequenceséquence spécifiée dans cette séquence.
      StringBuffer insert​(int offset, Object obj)
      Insère la représentation sous forme de chaîne de l'argumentObjectdans cette séquence de caractères.
      StringBuffer insert​(int offset, String str)
      Insère une chaîne dans cette séquence de caractères.
      int lastIndexOf​(String str)
      Retourne l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne.
      int lastIndexOf​(String str, int fromIndex)
      Retourne l'index de la dernière occurrence de la sous-chaîne spécifiée, en effectuant une recherche arrière à partir de l'index donné.
      int offsetByCodePoints​(int index, int codePointOffset)
      Retourne l'index dans cette séquence, à partir duquelindexDécalage codePointOffsetPoint de code.
      StringBuffer replace​(int start, int end, String str)
      Remplace les caractères d'une sous-chaîne de cette séquenceStringpar les caractères spécifiés.
      StringBuffer reverse()
      Remplace cette séquence de caractères par son inverse.
      void setCharAt​(int index, char ch)
      Le caractère à l'index spécifié est défini surch 。
      void setLength​(int newLength)
      Définit la longueur de la séquence de caractères.
      CharSequence subSequence​(int start, int end)
      Retourne une nouvelle séquence de caractères qui est une sous-séquence de cette séquence.
      String substring​(int start)
      Retourne une nouvelleString contenant une sous-séquence des caractères actuellement contenus dans cette séquence de caractères.
      String substring​(int start, int end)
      Retourne une nouvelleString contenant une sous-séquence des caractères actuellement contenus dans cette séquence.
      void trimToSize()
      Tente de réduire l'espace de stockage utilisé pour la séquence de caractères.
    • 构造方法详细信息

      • StringBuffer

        public StringBuffer()
        Construit un tampon de chaîne sans caractères, avec une capacité initiale de 16 caractères.
      • StringBuffer

        public StringBuffer​(int capacity)
        Construit un tampon de chaîne sans caractères, avec la capacité initiale spécifiée.
        Paramètres
        capacity- Capacité initiale. Exceptions
        NegativeArraySizeException - 如果 capacityle paramètre est inférieur à 0.
      • StringBuffer

        public StringBuffer​(String str)
        Construit un tampon de chaîne initialisé avec le contenu de la chaîne spécifiée. La capacité initiale du tampon de chaîne est16plus la longueur de l'argument de chaîne.
        Paramètres
        str- Contenu initial du tampon.
      • StringBuffer

        public StringBuffer​(CharSequence seq)
        Construit un tampon de chaîne contenant les mêmes caractères que laCharSequenceséquence spécifiée. La capacité initiale du tampon de chaîne est16加上CharSequence. Si la longueur de la

        CharSequenceséquence spécifiée est inférieure ou égale à zéro, un tampon vide de capacité16est retourné.

        Paramètres
        seq- Séquence à copier. Depuis la version : 1.5
    • 方法详细信息

      • compareTo

        public int compareTo​(StringBuffer another)
        StringBufferCompare deux instances dans l'ordre lexicographique.StringBufferCette méthode suit les mêmes règles de comparaison lexicographique que la méthode CharSequence.compare(this, another). Pour une comparaison de String fine et sensible aux paramètres régionaux, consultez

        Collator.

        Spécifié par :
        compareTo ,界面 Comparable<StringBuffer>
        Note d'implémentation : cette méthode se synchronise sur
        this (l'objet courant), mais ne se synchronise pas avec this StringBuffer, tandis que StringBuffer anotherest comparé à this StringBuffer. Paramètre
        another - StringBufferle StringBuffer
        à comparer. Valeur renvoyée
        0如果此StringBuffercontient la même séquence de caractères que l'argumentStringBuffer; si ceStringBufferest lexicographiquement inférieur àStringBuffer参数, StringBufferun entier négatif ; si ceStringBufferest lexicographiquement supérieur àStringBuffer参数, StringBufferun entier positif. Depuis la version : 11
      • capacity

        public int capacity()
        Renvoie la capacité actuelle. La capacité est la quantité de stockage disponible pour les nouveaux caractères insérés, au-delà de laquelle une allocation sera effectuée.
        Valeur renvoyée : la capacité actuelle
      • ensureCapacity

        public void ensureCapacity​(int minimumCapacity)
        Garantit une capacité au moins égale au minimum spécifié. Si la capacité actuelle est inférieure à l'argument, un nouveau tableau interne de plus grande capacité est alloué. La nouvelle capacité est le plus grand des deux :
        • minimumCapacityl'argument.
        • Le double de l'ancienne capacité, plus2 。
        Si l'argumentminimumCapacityest non positif, cette méthode ne fait rien et renvoie simplement. Notez que des opérations ultérieures sur cet objet peuvent réduire la capacité réelle en dessous de la capacité demandée ici.
        Paramètre
        minimumCapacity- la capacité minimale requise.
      • trimToSize

        public void trimToSize()
        Tente de réduire le stockage utilisé pour la séquence de caractères. Si le tampon est plus grand que nécessaire pour conserver sa séquence de caractères actuelle, il est redimensionné pour gagner de l'espace. L'appel de cette méthode peut, mais sans obligation, affecter la valeur renvoyée par les appels ultérieurs à la méthodecapacity().
        Depuis la version : 1.5
      • setLength

        public void setLength​(int newLength)
        Définit la longueur de la séquence de caractères. La séquence devient une nouvelle séquence dont la longueur est spécifiée par l'argument. Pour tout index non négatif knewLengthinférieur à la longueur de l'ancienne séquence, le caractère à l'index k de la nouvelle séquence est identique au caractère à l'index k de l'ancienne séquence. Sinon, il s'agit du caractère nul'\u0000'. En d'autres termes, sinewLengthl'argument est inférieur à la longueur actuelle, la longueur devient la longueur spécifiée. Si

        newLengthl'argument est supérieur ou égal à la longueur actuelle, des caractères nuls suffisants sont ajoutés ( '\u0000' ) pour que la longueur atteigne celle de l'newLength参数。

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

        Paramètres
        newLength- la nouvelle longueur Exceptions
        IndexOutOfBoundsException - 如果 newLengthargument est négatif. Voir aussi :
        CharSequence.length()
      • charAt

        public char charAt​(int index)
        Retourne la valeurcharà l'index spécifié dans cette séquence. La premièrecharvaleur se trouve à l'index0 , la suivante à l'index1, et ainsi de suite, comme pour les index de tableau. L'argument index doit être supérieur ou égal à

        0et inférieur à la longueur de cette séquence.

        Si la valeurcharsituée à l'index spécifié est un surrogate, la valeur du surrogate est retournée.

        Specified by:
        charAtDans l'interface CharSequence
        Paramètres
        index - l'index de la valeur charsouhaitée. Résultat La valeur
        charà l'index spécifié. Exceptions
        IndexOutOfBoundsException - 如果 index为负数或大于或等于 length(). Voir aussi :
        CharSequence.length()
      • codePointAt

        public int codePointAt​(int index)
        Retourne le caractère (point de code Unicode) à l'index spécifié. L'index fait référence auxcharvaleurs (unités de code Unicode), qui vont de0àCharSequence.length() - 1. Si la valeur

        charsituée à l'index donné est dans la plage des surrogates hauts, si l'index suivant est inférieur à la longueur de cette séquence, et si la valeurcharà l'index suivant est dans la plage des surrogates bas, alors le point de code supplémentaire correspondant à cette paire de surrogates est retourné. Sinon, la valeurchar值。

        Paramètres
        index - charIndex de la valeur, valeur de retour, point de code du caractère à la position
        indexException
        IndexOutOfBoundsException - 如果 indexcodePointBefore
      • codePointBefore

        public int codePointBefore​(int index)
        valeurs (unités de code Unicode), qui vont decharà1.CharSequence.length()。 Si

        char在值(index - 1)se trouve dans la plage des low surrogates, (index - 2)n'est pas négative, etchar在值(index - 2)se trouve dans la plage des high surrogates, alors la méthode renvoie la valeur du point de code supplémentaire de la paire de surrogates. Sichar在值index - 1est un low surrogate ou un high surrogate non apparié, alors la méthode renvoie la valeur de substitution en question.

        Paramètres
        index- index le point de code Unicode avant l'index donné. Résultat la valeur du point de code à renvoyer. Exceptions
        IndexOutOfBoundsException - 如果 indexLe paramètre est inférieur à 1 ou supérieur à la longueur de cette séquence. Depuis la version : 1.5
      • codePointCount

        public int codePointCount​(int beginIndex,
                                  int endIndex)
        Retourne le nombre de points de code Unicode dans la plage de texte spécifiée de cette séquence. La plage de texte commence aubeginIndex et s'étend jusqu'àchar在索引endIndex - 1。 Ainsi, la longueur de la plage de texte (danschar s) estendIndex-beginIndex。 Chaque agent non apparié de cette séquence compte comme un point de code.
        Paramètres
        beginIndex - Index du premier charélément de la plage de texte.
        endIndex - Index situé après le dernier charélément de la plage de texte. Résultat Nombre de points de code Unicode dans la plage de texte spécifiée Exceptions
        IndexOutOfBoundsException - 如果 beginIndexest négatif, ou si endIndexest supérieur à la longueur de cette séquence, ou si beginIndex大于 endIndex. Depuis la version : 1.5
      • offsetByCodePoints

        public int offsetByCodePoints​(int index,
                                      int codePointOffset)
        Renvoie l'index dans cette séquence, cet index part duindex偏移codePointOffseten points de code donné.index和codePointOffsetles substituts non appariés dans la plage de texte donnée comptent pour un point de code chacun.
        Paramètres
        index- l'index à décaler
        codePointOffset- le décalage en points de code. Résultat : l'index dans cette séquence. Exceptions
        IndexOutOfBoundsException - 如果 indexest négatif ou supérieur à la longueur de cette séquence, ou si codePointOffsetest positif et si la sous-chaîne à partir de indexcompte moins de codePointOffsetpoints de code, ou si codePointOffset ,或者 codePointOffsetla sous-chaîne avant indexcompte moins que la valeur absolue de la valeur absolue indexen points de code. Depuis la version : 1.5 codePointOffset代码点。
        Depuis la version : 1.5
      • getChars

        public void getChars​(int srcBegin,
                             int srcEnd,
                             char[] dst,
                             int dstBegin)
        Copie les caractères de cette séquence vers le tableau de caractères cibledst. Le premier caractère à copier est à l'indexsrcBegin; le dernier caractère à copier est à l'indexsrcEnd-1. Le nombre total de caractères à copier estsrcEnd-srcBegin. Les caractères sont copiés dans le sous-tableau dedstà partir de l'indexdstBeginet jusqu'à l'index :
           dstbegin + (srcEnd-srcBegin) - 1  
        Paramètres
        srcBegin- commence la copie à partir de ce décalage.
        srcEnd- arrête la copie à ce décalage.
        dst- le tableau vers lequel copier les données.
        dstBegin - le décalage dans dst. Exceptions
        IndexOutOfBoundsException- si l'une des conditions suivantes est remplie :
        • srcBegin是否定的
        • dstBegin是否定的
        • srcBeginle paramètre est supérieur au paramètresrcEnd参数。
        • srcEnd大于this.length() 。
        • dstBegin+srcEnd-srcBegin大于dst.length
      • setCharAt

        public void setCharAt​(int index,
                              char ch)
        Définit le caractère à l'index spécifié surch. La séquence est modifiée pour représenter une nouvelle séquence de caractères identique à la séquence originale, sauf qu'elle contient le caractèrechà la positionindex. L'argument index doit être supérieur ou égal à

        0et inférieur à la longueur de cette séquence.

        Paramètres
        index- L'index du caractère à modifier.
        ch- Le nouveau caractère. Exception
        IndexOutOfBoundsException - 如果 index为负数或大于或等于 length(). Voir aussi :
        CharSequence.length()
      • append

        public StringBuffer append​(Object obj)
        AjouteObjectla représentation sous forme de chaîne de l'argument. L'effet global est identique à la conversion de l'argument en chaîne par la méthode

        String.valueOf(Object), puis à l'ajout des caractères de cette chaîneappendedà cette séquence de caractères.

        Paramètres
        obj - Object. Résultat Une référence à cet objet.
      • append

        public StringBuffer append​(String str)
        Ajoute la chaîne spécifiée à cette séquence de caractères.

        StringLes caractères de l'argument sont ajoutés dans l'ordre. La longueur de cette séquence augmente de la longueur de l'argument. Sistr是null ,则附加四个字符"null" 。

        Soit n la longueur de cette séquence de caractères avant l'exécution de la méthodeappend. Si k est inférieur à n, alors le caractère à l'index k dans la nouvelle séquence est égal au caractère à l'index k dans l'ancienne séquence. Sinon, il est égal au caractère à l'index k-n dans l'argumentstr.

        Paramètres
        str- Une chaîne. Résultat Une référence à cet objet.
      • append

        public StringBuffer append​(StringBuffer sb)
        Ajoute leStringBufferspécifié à cette séquence. Les caractères de l'argument

        StringBuffersont ajoutés dans l'ordre. Le contenuStringBuffer augmente la longueur de cetteStringBufferde la longueur de l'argument. Sisb是null , alors les quatre caractères"null"sont ajoutés à cette séquenceStringBuffer 。

        Soit n la longueur de l'ancienne séquence de caractères, c'est-à-dire la longueur de la séquence contenue avant l'exécution de laappend方法之前StringBufferSi k est inférieur à n, le caractère à l'index k de la nouvelle séquence est égal au caractère à l'index k de l'ancienne séquence. Sinon, il est égal au caractère à l'index k-n de l'argumentsb.

        Cette méthode se synchronise sur l'objet ciblethis同步,但不在源上同步( sb )。

        Paramètres
        sb - 要追加的 StringBufferà ajouter. Résultat : une référence à cet objet. Depuis la version : 1.4
      • append

        public StringBuffer append​(CharSequence s)
        Ajoute leCharSequencespécifié à cette séquence.

        CharSequenceLes caractères de l'argument sont ajoutés dans l'ordre. La longueur de cette séquence augmente de la longueur de l'argument.

        Le résultat de cette méthode est exactement identique à l'appel this.append(s, 0, s.length()).

        Cette méthode se synchronise sur l'objet ciblethis同步,但不在源上同步( s )。

        Sis是null ,则附加四个字符"null" 。

        Spécifié par :
        append接口 Appendable
        Paramètres
        s - 要追加的 CharSequenceà ajouter. Résultat : une référence à cet objet. Depuis la version : 1.5
      • append

        public StringBuffer append​(CharSequence s,
                                   int start,
                                   int end)
        Ajoute laCharSequenceséquence spécifiée à cette séquence. Les caractères de l'argument

        startà partir de l'indexssont ajoutés dans l'ordre au contenu de cette séquence, jusqu'à l'indexendexclu. La longueur de cette séquence augmente de la valeur deend - start.

        Soit n la longueur de cette séquence de caractères avant l'exécution de laappendméthode. Alors, si k est inférieur à n, le caractère à l'index k de cette séquence devient égal au caractère à l'index k de cette séquence. Sinon, il est égal ausà l'index k+start-n de l'arguments 。

        Sis是null , alors cette méthode ajoute les caractères comme si l'argument s était une séquence contenant quatre"null"的序列"null" 。

        Spécifié par :
        append在接口 Appendable
        Paramètres
        s- La séquence à ajouter.
        start- L'index de début de la sous-séquence à ajouter.
        end- L'index de fin de la sous-séquence à ajouter. Valeur retournée Une référence à cet objet. Exceptions
        IndexOutOfBoundsException - 如果 start为负数,或 start大于 end或 end大于 s.length()
        Disponible depuis la version : 1.5
      • append

        public StringBuffer append​(char[] str)
        Ajoute lacharreprésentation sous forme de chaîne de l'argument tableau à cette séquence. Les caractères de l'argument tableau sont ajoutés dans l'ordre au contenu de cette séquence. La longueur de cette séquence augmente de la longueur de l'argument.

        L'effet global est comme si l'argument était converti en chaîne par la méthodeString.valueOf(char[]), puis que les caractères de cette chaîne étaientappendedà cette séquence de caractères.

        Paramètres
        str- Les caractères à ajouter. Valeur retournée Une référence à cet objet.
      • append

        public StringBuffer append​(char[] str,
                                   int offset,
                                   int len)
        Ajoute lacharreprésentation sous forme de chaîne d'un sous-tableau de l'argument tableau à cette séquence. Les

        offset开始的char阵列strsont ajoutés dans l'ordre au contenu de cette séquence. La longueur de cette séquence augmente de la valeurlen 。

        L'effet global est comme si l'argument était converti en chaîne par la méthodeString.valueOf(char[],int,int), puis que les caractères de cette chaîne étaientappendedà cette séquence de caractères.

        Paramètres
        str- Les caractères à ajouter.
        offset - L'index du premier charà ajouter.
        len - 要追加的 chars à ajouter. Valeur retournée Une référence à cet objet. Exceptions
        IndexOutOfBoundsException - Si l'argument est offset < 0或 len < 0或 offset+len > str.length
      • append

        public StringBuffer append​(boolean b)
        ajoutebooleanla représentation sous forme de chaîne de l'argument à la séquence. L'effet global est exactement le même que si l'argument était converti en chaîne par la méthode

        String.valueOf(boolean), puis que les caractères de cette chaîne étaient ajoutésappendedà cette séquence de caractères.

        Paramètres
        b - a boolean. Résultat Une référence à cet objet.
      • append

        public StringBuffer append​(char c)
        ajoutecharla représentation sous forme de chaîne de l'argument à cette séquence. L'argument est ajouté au contenu de cette séquence. La longueur de cette séquence augmente de

        1 。

        L'effet global est exactement le même que si l'argument était converti en chaîne par la méthodeString.valueOf(char), puis que les caractères de cette chaîne étaient ajoutésappended.

        Spécifié par :
        append在接口 Appendable
        Paramètres
        c - a char. Résultat Une référence à cet objet.
      • append

        public StringBuffer append​(int i)
        ajouteintla représentation sous forme de chaîne de l'argument à cette séquence. L'effet global est le même que si l'argument était converti en chaîne par la méthode

        String.valueOf(int), puis que les caractères de cette chaîne étaient ajoutésappendedà cette séquence de caractères.

        Paramètres
        i - int. Résultat Une référence à cet objet.
      • appendCodePoint

        public StringBuffer appendCodePoint​(int codePoint)
        ajoutecodePointla représentation sous forme de chaîne de l'argument à cette séquence. L'argument est ajouté au contenu de cette séquence. La longueur de cette séquence augmente de

        Character.charCount(codePoint).

        L'effet global est exactement le même que si l'argument était converti en tableauCharacter.toChars(int)将参数转换为char, puis que les caractères de ce tableau étaient ajoutésappendedà cette séquence de caractères.

        Paramètres
        codePoint- Point de code Unicode Résultat Référence à cet objet. Depuis la version : 1.5
      • append

        public StringBuffer append​(long lng)
        Ajoute lalongreprésentation sous forme de chaîne de l'argument à cette séquence. L'effet global est identique à celui de la méthode

        String.valueOf(long)qui convertit l'argument en chaîne, puis les caractères de cette chaîne deviennent ceux de cette séquence de caractèresappended.

        Paramètres
        lng - a long. Résultat Référence à cet objet.
      • append

        public StringBuffer append​(float f)
        Ajoutefloatla représentation sous forme de chaîne du paramètre à cette séquence. L'effet global est identique à celui obtenu en convertissant le paramètre en chaîne via la méthode

        String.valueOf(float), puis en ajoutant les caractères de cette chaîne à cette séquence de caractèresappended.

        Paramètre
        f - a float. Résultat : une référence à cet objet.
      • append

        public StringBuffer append​(double d)
        Ajoutedoublela représentation sous forme de chaîne du paramètre à cette séquence. L'effet global de la méthode

        String.valueOf(double)Convertit les paramètres en une chaîne exactement identique, puis les caractères de cette chaîne sontappended.

        Paramètre
        d - a double. Résultat : une référence à cet objet.
      • delete

        public StringBuffer delete​(int start,
                                   int end)
        Supprime les caractères d'une sous-chaîne de cette séquence. La sous-chaîne commence à l'index spécifiéstartet s'étend jusqu'au caractère à l'indexend - 1ou à la fin de la séquence si ce caractère n'existe pas. Sistart等于end, aucune modification n'est effectuée.
        Paramètres
        start- l'index de début, inclus.
        end- l'index de fin, exclu. Résultat Cet objet. Exceptions
        StringIndexOutOfBoundsException - 如果 start为负数,大于 length() ,或大于 end. Depuis la version : 1.2
      • deleteCharAt

        public StringBuffer deleteCharAt​(int index)
        Supprime le caractère à la position spécifiée, dans cet ordre.char。 Cette séquence estcharraccourcie. Remarque : si le caractère à l'index donné est un caractère supplémentaire, cette méthode ne supprime pas le caractère entier. Si un traitement précis des caractères supplémentaires est nécessaire, déterminez le nombre

        charà supprimer en appelantCharacter.charCount(thisSequence.codePointAt(index)) ,其中thisSequenceest cette séquence.

        Paramètres
        index - l'index à supprimer char
        Résultat cet objet. Exceptions
        StringIndexOutOfBoundsException - 如果 index为负数或大于或等于 length(). Depuis la version : 1.2
      • replace

        public StringBuffer replace​(int start,
                                    int end,
                                    String str)
        Remplace les caractères d'une sous-chaîne de cette séquence par laStringspécifiée. La sous-chaîne commence à l'indexstartspécifié et s'étend jusqu'au caractère à l'indexend - 1ou à la fin de la séquence si un tel caractère n'existe pas. Les caractères de la sous-chaîne sont d'abord supprimés, puis laStringspécifiée est insérée enstart. (Cette séquence est allongée si nécessaire pour contenir la chaîne spécifiée.)
        Paramètres
        start- l'index de début, inclus.
        end- l'index de fin, exclu.
        str- la chaîne qui remplacera le contenu précédent. Résultat cet objet. Exceptions
        StringIndexOutOfBoundsException - 如果 start为负数,大于 length() ,或大于 end. Depuis la version : 1.2
      • substring

        public String substring​(int start)
        Retourne une nouvelleStringcontenant la sous-séquence des caractères actuellement contenus dans cette séquence de caractères. La sous-chaîne commence à l'index spécifié et s'étend jusqu'à la fin de cette séquence.
        Paramètres
        start- l'index de début, inclus. Résultat la nouvelle chaîne. Exceptions
        StringIndexOutOfBoundsException - 如果 startest inférieur à zéro, ou supérieur à la longueur de cet objet. Depuis la version : 1.2
      • subSequence

        public CharSequence subSequence​(int start,
                                        int end)
        Retourne une nouvelle séquence de caractères qui est une sous-séquence de cette séquence. Un appel de cette méthode de la forme

           sb.subSequence(begin,&nbsp;end) 
        se comporte exactement comme l'appel
           sb.substring(begin,&nbsp;end) 
        Cette méthode est fournie pour que cette classe puisse implémenter l'interfaceCharSequence.
        Specified by:
        subSequence ,界面 CharSequence
        Paramètres
        start- Index de début, inclus.
        end- Index de fin, exclus. Résultat La sous-séquence spécifiée. Exceptions
        IndexOutOfBoundsException - 如果 start或 endest négatif, si end大于 length() ,或者 start大于 end
        Depuis la version : 1.4
      • substring

        public String substring​(int start,
                                int end)
        Retourne une nouvelleStringcontenant la sous-séquence des caractères actuellement contenus dans cette séquence. La sous-chaîne commence austartspécifié et s'étend jusqu'au caractère à l'indexend - 1.
        Paramètres
        start- Index de début, inclus.
        end- Index de fin, exclus. Résultat La nouvelle chaîne. Exceptions
        StringIndexOutOfBoundsException - 如果 start或 end为负数或大于 length() ,或 start大于 end. Depuis la version : 1.2
      • insert

        public StringBuffer insert​(int index,
                                   char[] str,
                                   int offset,
                                   int len)
        Insère la représentation sous forme de chaîne d'une sous-matrice du paramètre de matricestrdans cette séquence. La sous-matrice commence auoffsetspécifié et s'étend jusqu'àlen chars. Les caractères de la sous-matrice sont insérés dans cette séquence à la position indiquée parindex. La longueur de cette séquence augmente delen chars.
        Paramètres
        index- Position d'insertion de la sous-matrice.
        str - Une charmatrice.
        offset - Index du premier charde la sous-matrice à insérer.
        len - Nombre de chars de la sous-matrice à insérer. Résultat Cet objet Exceptions
        StringIndexOutOfBoundsException - 如果 index为负数或大于 length() ,或 offset或 len为负数,或 (offset+len)大于 str.length. Depuis la version : 1.2
      • insert

        public StringBuffer insert​(int offset,
                                   Object obj)
        Insère la représentation sous forme de chaîne de l'argumentObjectdans cette séquence de caractères. L'effet global est identique à celui obtenu en convertissant le second argument en chaîne par la méthode

        String.valueOf(Object), puis en insérant les caractères de cette chaîne dans cette séquence à l'offset spécifiéinserted.

        offset参数必须大于或等于0, et inférieur ou égal à la length de cette séquence.

        Paramètres
        offset- l'offset.
        obj - Object. Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si l'offset est invalide.
      • insert

        public StringBuffer insert​(int offset,
                                   String str)
        Insère une chaîne dans cette séquence de caractères.

        StringLes caractères de l'argument sont insérés dans l'ordre dans cette séquence à l'offset spécifié. Les caractères situés initialement au-dessus de cette position sont décalés vers le haut. La longueur de la séquence augmente de la longueur de l'argument. Sistr是null ,则将四个字符"null"sont insérés dans cette séquence.

        Le caractère à l'index k dans la nouvelle séquence de caractères est égal à :

        • le caractère à l'index k dans l'ancienne séquence de caractères, si k est inférieur àoffsetParamètres
        • le caractère à l'indexstrk-offsetdans l'argument, si k n'est pas inférieur àoffset但小于offset+str.length()
        • le caractère à l'index-str.length()koffset+str.length()

        offset参数必须大于或等于0L'argument doit être supérieur ou égal à

        , et inférieur ou égal à la length de cette séquence.
        offsetParamètres
        str- l'offset.
        StringIndexOutOfBoundsException- une chaîne. Résultat une référence à cet objet. Exceptions
      • insert

        public StringBuffer insert​(int offset,
                                   char[] str)
        Insère lacharreprésentation sous forme de chaîne de l'argument tableau dans cette séquence. Les caractères de l'argument tableau sont

        offsetinsérés dans le contenu de cette séquence à la position indiquée. La longueur de cette séquence augmente de la longueur de l'argument.

        L'effet global est identique à celui obtenu en convertissant le second argument en chaîne par la méthodeString.valueOf(char[])puis en insérant les caractères de cette chaîne dans cette séquence de caractères à l'offset indiquéinserted.

        offset参数必须大于或等于0et inférieur ou égal à la longueur de cette séquence.

        Paramètres
        offset- l'offset.
        str- le tableau de caractères. Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si l'offset est invalide.
      • insert

        public StringBuffer insert​(int dstOffset,
                                   CharSequence s)
        Insère laCharSequencechaîne spécifiée dans cette séquence.

        CharSequenceLes caractères de l'argument sont insérés dans cette séquence à l'offset indiqué, dans l'ordre. Les caractères situés initialement au-dessus de cette position sont décalés vers le haut. La longueur de cette séquence augmente de la longueur de l'argument s.

        Le résultat de cette méthode est identique à celui de l'appel de la méthodeinsert(dstOffset, s, 0, s.length()) sur cet objet.

        Sis是null ,则将四个字符"null"sont insérés dans cette séquence.

        Paramètres
        dstOffset- l'offset.
        s- la séquence à insérer. Résultat une référence à cet objet. Exceptions
        IndexOutOfBoundsException- si l'offset est invalide. Depuis la version : 1.5
      • insert

        public StringBuffer insert​(int dstOffset,
                                   CharSequence s,
                                   int start,
                                   int end)
        Insère laCharSequenceséquence spécifiée dans cette séquence. La sous-séquence de l'argument

        sindiquée parstart和endest insérée à l'offset de destination indiqué dans cette séquence. Les caractères situés initialement au-dessus de cette position sont décalés vers le haut. La longueur de cette séquence augmente deend - start 。

        Le caractère à l'index k dans cette séquence devient égal à :

        • le caractère à l'index k dans cette séquence si k est inférieur àdstOffset,
        • le caractère à l'index ksdans l'argument+start-dstOffsetsi k est supérieur ou égal àdstOffset但小于dstOffset+end-start
        • Si k est supérieur ou égal àdstOffset+end-start, alors le caractère d'indice k-(end-start)dans cette séquence

        dstOffset参数必须大于或等于0, et inférieur ou égal au length de cette séquence.

        Le paramètre start doit être non négatif, et ne pas dépasserend 。

        Le paramètre de fin doit être supérieur ou égal àstart, et inférieur ou égal à la longueur de s.

        Sis是null , cette méthode insère les caractères comme si le paramètre s était une chaîne de quatre caractères"null"的序列"null" 。

        Paramètres
        dstOffset- Décalage dans cette séquence.
        s- La séquence à insérer.
        start- L'index de départ de la sous-séquence à insérer.
        end- Endindex der einzufügenden Teilzeichenfolge. Ergebnis: eine Referenz auf dieses Objekt. Ausnahme
        IndexOutOfBoundsException - 如果 dstOffset为负数或大于 this.length() ,或 start或 end为负数,或 start大于 end或 end大于 s.length()
        从以下版本开始:
        1.5
      • insert

        public StringBuffer insert​(int offset,
                                   boolean b)
        InsérerbooleanLa représentation sous forme de chaîne de l'argument est insérée dans cette séquence. L'effet global est identique à celui obtenu en convertissant

        String.valueOf(boolean)le second argument en chaîne par la méthode, puis en insérant les caractères de cette chaîne dans cette séquence de caractères à l'offset indiquéinserted.

        offset参数必须大于或等于0, et inférieur ou égal à la length de cette séquence.

        Arguments
        offset- l'offset.
        b - a boolean. Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si l'offset est invalide.
      • insert

        public StringBuffer insert​(int offset,
                                   char c)
        Insère lacharreprésentation sous forme de chaîne de l'argument dans cette séquence. L'effet global est identique à celui de la méthode

        String.valueOf(char)qui convertit le second argument en chaîne, puis les caractères de cette chaîne entrent dans la séquence à l'offset indiquéinserted.

        offset参数必须大于或等于0, et inférieur ou égal au length de cette séquence.

        Paramètres
        offset- offset.
        c - a char. Résultat une référence à cet objet. Exceptions
        IndexOutOfBoundsException- si l'offset est invalide.
      • insert

        public StringBuffer insert​(int offset,
                                   int i)
        Insère la représentation sous forme de chaîne du secondintargument dans cette séquence. L'effet global est identique à celui de la méthode

        String.valueOf(int)qui convertit le second argument en chaîne, puis les caractères de cette chaîne entrent dans la séquence à l'offset indiquéinserted.

        offset参数必须大于或等于0, et inférieur ou égal au length de cette séquence.

        Paramètres
        offset- offset.
        i - int. Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si l'offset est invalide.
      • insert

        public StringBuffer insert​(int offset,
                                   long l)
        Insère lalongreprésentation sous forme de chaîne de l'argument dans cette séquence. L'effet global est identique à celui de la méthode

        String.valueOf(long)qui convertit le second argument en chaîne, puis les caractères de cette chaîne entrent dans la séquence à l'offset indiquéinserted.

        offset参数必须大于或等于0, et inférieur ou égal au length de cette séquence.

        Paramètres
        offset- offset.
        l - a long. Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si l'offset est invalide.
      • insert

        public StringBuffer insert​(int offset,
                                   float f)
        Insère lafloatreprésentation sous forme de chaîne de l'argument dans cette séquence. L'effet global est identique à celui de la méthode

        String.valueOf(float)qui convertit le second argument en chaîne, puis les caractères de cette chaîne entrent dans la séquence à l'offset indiquéinserted。

        offset参数必须大于或等于0, et inférieur ou égal au length de cette séquence.

        Paramètres
        offset- l'offset.
        f - a float. Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si l'offset est invalide.
      • insert

        public StringBuffer insert​(int offset,
                                   double d)
        Insèredoublela représentation sous forme de chaîne du paramètre dans cette séquence. L'effet global est identique à celui de la méthode

        String.valueOf(double)qui convertit le second paramètre en chaîne, puis les caractères de cette chaîne sont insérés dans cette séquence à l'offset indiquéinserted.

        offset参数必须大于或等于0, et inférieur ou égal au length de cette séquence.

        Paramètres
        offset- l'offset.
        d - a double. Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si l'offset est invalide.
      • indexOf

        public int indexOf​(String str)
        Retourne l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne. L'index retourné est la valeur minimale

        k ,其中:

           this.toString().startsWith(str, k)  
        Si aucune valeur de ce typek存在,那么-1返回。
        Paramètres
        str- la sous-chaîne à rechercher. Résultat l'index de la première occurrence de la sous-chaîne spécifiée, ou si ce n'est pas le cas
        -1. Depuis la version : 1.4
      • indexOf

        public int indexOf​(String str,
                           int fromIndex)
        À partir de l'index spécifié, retourne l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne. L'index retourné est la valeur minimale

        k ,其中:

           k >= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)  
        Si aucune valeur de ce typek存在,那么-1返回。
        Paramètres
        str- la sous-chaîne à rechercher.
        fromIndex- l'index de départ de la recherche. Résultat l'index de la première occurrence de la sous-chaîne spécifiée à partir de l'index indiqué, ou si ce n'est pas le cas
        -1. Depuis la version : 1.4
      • lastIndexOf

        public int lastIndexOf​(String str)
        Retourne l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne. La dernière occurrence de la chaîne vide "" est considérée comme se trouvant à la valeur d'indexthis.length(). L'index retourné est la plus grande valeur

        k ,其中:

           this.toString().startsWith(str, k)  
        Si aucune valeur de ce typek存在,那么-1返回。
        Paramètres
        str- la sous-chaîne à rechercher. Résultat L'index de la dernière occurrence de la sous-chaîne spécifiée, ou si ce n'est pas le cas,
        -1. Depuis la version : 1.4
      • lastIndexOf

        public int lastIndexOf​(String str,
                               int fromIndex)
        Retourne l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne, en effectuant la recherche en arrière à partir de l'index spécifié. L'index retourné est la plus grande valeur

        k ,其中:

           k <= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)  
        Si aucune valeur de ce typek存在,那么-1返回。
        Paramètres
        str- la sous-chaîne à rechercher.
        fromIndex- l'index à partir duquel la recherche commence. Résultat L'index de la dernière occurrence de la sous-chaîne spécifiée, en recherchant en arrière à partir de l'index spécifié, ou si ce n'est pas le cas
        -1lors de la recherche. Depuis la version : 1.4
      • reverse

        public StringBuffer reverse()
        Cause le remplacement de cette séquence de caractères par son inverse. Si la séquence contient des paires de substitution, celles-ci sont traitées comme des caractères uniques lors de l'opération inverse. Ainsi, l'ordre des substituts hauts et bas n'est jamais inversé. Soit n la longueur en caractères de cette séquence de caractères avant l'exécution de lareverseméthode (et non la longueur dans lacharvaleur). Alors, le caractère à l'index k dans la nouvelle séquence de caractères est égal au caractère à l'index n-k-1 dans l'ancienne séquence. Notez que l'opération inverse peut produire des paires de substitution à partir de substituts bas et hauts non appariés avant l'opération. Par exemple, inverser "\uDC00\uD800" génère "\uD800\uDC00", qui est une paire de substitution valide.

        Résultat Une référence à cet objet. Depuis la version : 1.0.2
      • chars

        public IntStream chars()
        Retourne un fluxintdecharvaleurs, avec extension zéro pour les valeurs de cette séquence. Tout caractère mappé à un surrogate code point est passé sans interprétation. Lorsque l'opération terminale du flux démarre, le flux est lié à cette séquence (en particulier, pour les séquences mutables, le spliterator du flux est late-binding). Si la séquence est modifiée pendant cette opération, le résultat est indéfini.

        Spécifié par :
        chars在接口 CharSequence
        Résultat Un IntStream des valeurs char de cette séquence. Depuis la version : 9
      • codePoints

        public IntStream codePoints()
        Retourne un flux des valeurs de points de code de cette séquence. Toute paire de substitution rencontrée dans la séquence est combinée comme avec Character.toCodePoint, et le résultat est passé au flux. Toute autre unité de code (y compris les caractères BMP ordinaires, les substituts non appariés et les unités de code non définies) est étendue par zéro enintvaleur, puis passée au flux. Lorsque l'opération terminale du flux démarre, le flux est lié à cette séquence (en particulier, pour les séquences mutables, le spliterator du flux est late-binding). Si la séquence est modifiée pendant cette opération, le résultat est indéfini.

        Spécifié par :
        codePointsdans CharSequence
        Résultat Un IntStream des points de code Unicode de cette séquence. Depuis la version : 9