模块  java.base
Paquetage java.lang

Class StringBuilder

  • Interfaces implémentées
    Serializable ， Appendable ， CharSequence ， Comparable<StringBuilder> 
    public final class StringBuilder
extends Object
implements Serializable, Comparable<StringBuilder>, CharSequence
    Une séquence de caractères mutable. Cette classe fournit une API compatible avecStringBuffermais ne garantit pas la synchronisation. Cette classe est conçue commeStringBufferun remplacement de StringBuffer dans les cas d'utilisation mono-thread (le cas général). Si possible, utilisez cette classe de préférence àStringBufferparce qu'elle est plus rapide dans la plupart des implémentations.

    StringBuilderLes principales opérations surappend和insertCes méthodes sont surchargées pour accepter des données de tout type. Chacune convertit les données en chaîne, puis ajoute ou insère les caractères de cette chaîne dans le générateur de chaînes.appendLa méthode ajoute toujours ces caractères à la fin du générateur.insertLa méthode ajoute les caractères à un point spécifié.

    Par exemple, sizdésigne un objet générateur de chaînes dont le contenu actuel est « start », alors l'appel de méthodez.append("le")provoque l'inclusion de « startle » dans le générateur de chaînes, tandis quez.insert(4, "le")modifie le générateur de chaînes pour qu'il contienne « starlet».

    En général, si une instanceStringBuilder ，然后sb.append(x)produit le même effet quesb.insert(sb.length(), x) 。

    Chaque générateur de chaînes possède une capacité. Tant que la longueur de la séquence de caractères ne dépasse pas la capacité, aucun nouveau tampon interne n'est alloué. Si le tampon interne déborde, il s'agrandit automatiquement.

    StringBuilderLes instances ne conviennent pas à une utilisation multi-threads. Si une telle synchronisation est nécessaire, utilisezStringBuffer.

    Sauf indication contraire, passer un paramètrenullnull à un constructeur ou à une méthode denullprovoque la levée d'une exceptionNullPointerException.

    Note API :
    StringBuilder实现Comparableexiste mais ne surcharge pasequals. Par conséquent, l'ordre naturel deStringBuildern'est pas cohérent avec equals. Si des objetsStringBuildersont utilisés comme clés dansStringBuilderou comme éléments dansSortedMap, SortedSet. VoirComparable,SortedMapouSortedSetpour plus d'informations. Depuis la version : 1.5. Voir aussi :
    StringBuffer,String, Serialized Form

    • 构造方法摘要

      构造方法  
      构造器 Description
      StringBuilder()
      Construit un générateur de chaînes sans caractères, avec une capacité initiale de 16 caractères.
      StringBuilder​(int capacity)
      Construit un générateur de chaînes sans caractères, avec une capacité initiale spécifiée par l'argumentcapacity.
      StringBuilder​(CharSequence seq)
      Construit un générateur de chaînes qui contient les mêmes caractères que leCharSequencespécifié.
      StringBuilder​(String str)
      Construit un générateur de chaînes initialisé avec le contenu de la chaîne spécifiée.

    • 方法摘要

      Toutes les méthodes Méthodes d'instance Méthodes concrètes Variable et type Méthode Description
      StringBuilder append​(boolean b)
      Ajoute la représentation sous forme de chaîne de l'argumentbooleanà la séquence.
      StringBuilder append​(char c)
      Ajoute la représentation sous forme de chaîne de l'argumentcharà cette séquence.
      StringBuilder append​(char[] str)
      Ajoute la représentation sous forme de chaîne de l'argumentchartableau à cette séquence.
      StringBuilder 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.
      StringBuilder append​(double d)
      Ajoute la représentation sous forme de chaîne de l'argumentdoubleà cette séquence.
      StringBuilder append​(float f)
      Ajoute la représentation sous forme de chaîne de l'argumentfloatà cette séquence.
      StringBuilder append​(int i)
      Ajoute la représentation sous forme de chaîne de l'argumentintà cette séquence.
      StringBuilder append​(long lng)
      Ajoute la représentation sous forme de chaîne de l'argumentlongà cette séquence.
      StringBuilder append​(CharSequence s)
      Ajoute la séquence de caractères spécifiée à ceAppendable 。
      StringBuilder append​(CharSequence s, int start, int end)
      Ajoute la séquenceCharSequencespécifiée à cette séquence.
      StringBuilder append​(Object obj)
      Ajoute la représentation sous forme de chaîne de l'argumentObject.
      StringBuilder append​(String str)
      Ajoute la chaîne spécifiée à cette séquence de caractères.
      StringBuilder append​(StringBuffer sb)
      Ajoute leStringBuffer追加到此序列。
      StringBuilder 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 fluxintavec 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​(StringBuilder another)
      StringBuilderCompare deux instances dans l'ordre StringBuilderlexicographique.
      StringBuilder delete​(int start, int end)
      Supprime les caractères dans la sous-chaîne de cette séquence.
      StringBuilder deleteCharAt​(int index)
      Supprime le caractère à la position spécifiéechar 。
      void ensureCapacity​(int minimumCapacity)
      Garantit que la capacité est 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)
      Renvoie 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)
      À partir de l'index spécifié, renvoie l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne.
      StringBuilder insert​(int offset, boolean b)
      Insère labooleanreprésentation sous forme de chaîne de l'argument dans cette séquence.
      StringBuilder insert​(int offset, char c)
      Insère lacharreprésentation sous forme de chaîne de l'argument dans cette séquence.
      StringBuilder insert​(int offset, char[] str)
      Insère lacharreprésentation sous forme de chaîne de l'argument de type tableau dans cette séquence.
      StringBuilder insert​(int index, char[] str, int offset, int len)
      Insère lastrreprésentation sous forme de chaîne du sous-tableau de l'argument de type tableau dans cette séquence.
      StringBuilder insert​(int offset, double d)
      Insère ladoublereprésentation sous forme de chaîne du paramètre dans cette séquence.
      StringBuilder insert​(int offset, float f)
      Insère lafloatreprésentation sous forme de chaîne du paramètre dans cette séquence.
      StringBuilder insert​(int offset, int i)
      Insère la représentation sous forme de chaîne du secondintparamètre dans cette séquence.
      StringBuilder insert​(int offset, long l)
      Insère lalongreprésentation sous forme de chaîne du paramètre dans cette séquence.
      StringBuilder insert​(int dstOffset, CharSequence s)
      Insère leCharSequence插入此序列。
      StringBuilder insert​(int dstOffset, CharSequence s, int start, int end)
      Insère laCharSequenceséquence spécifiée dans cette séquence.
      StringBuilder insert​(int offset, Object obj)
      Insère laObjectreprésentation sous forme de chaîne du paramètre dans cette séquence de caractères.
      StringBuilder 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 dans la chaîne, en effectuant la recherche vers l'arrière à partir de l'index spécifié.
      int length()
      Retourne la longueur (nombre de caractères).
      int offsetByCodePoints​(int index, int codePointOffset)
      Retourne l'index dans cette séquence, à partir duindexdécalage donné codePointOffsetPoint de code.
      StringBuilder replace​(int start, int end, String str)
      Remplace les caractères de la sous-chaîne de cette séquenceStringpar les caractères spécifiés.
      StringBuilder reverse()
      Provoque le remplacement de 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 celle-ci.
      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.

    • 构造方法详细信息

      • StringBuilder

        public StringBuilder()
        Construit un générateur de chaînes sans aucun caractère, avec une capacité initiale de 16 caractères.

      • StringBuilder

        public StringBuilder​(int capacity)
        Construit un générateur de chaînes sans caractères et aveccapacityla capacité initiale spécifiée par le paramètre.
        Paramètres
        capacity- Capacité initiale. Exceptions
        NegativeArraySizeException - 如果 capacityest inférieur à 0.

      • StringBuilder

        public StringBuilder​(String str)
        Construit un générateur de chaînes initialisé avec le contenu de la chaîne spécifiée. La capacité initiale du générateur est16plus la longueur du paramètre de type chaîne.
        Paramètres
        str- Contenu initial du tampon.

      • StringBuilder

        public StringBuilder​(CharSequence seq)
        Construit un générateur de chaînes contenant les mêmes caractères que leCharSequencespécifié. La capacité initiale du générateur est16加上CharSequence.
        Paramètres
        seq- Séquence à copier.

    • 方法详细信息

      • compareTo

        public int compareTo​(StringBuilder another)
        StringBuilderCompare l'ordre lexicographique de deuxStringBuilderinstances. Cette méthode suit les mêmes règles de comparaison lexicographique que celles définies dans la méthode CharSequence.compare(this, another). Pour une comparaison de chaînes fine et sensible aux paramètres régionaux, consultez

        Collator.

        Spécifié par :
        compareTo在接口 Comparable<StringBuilder>
        Paramètres
        another - le StringBuilder
        à comparer.
        0如果此StringBuildersi ceStringBuildercontient la même séquence de caractères que l'argument ; si ceStringBuilderest lexicographiquement inférieur àStringBuilder参数， StringBuilderun entier négatif ; si ceStringBuilderest lexicographiquement supérieur àStringBuilder参数， StringBuilderun entier positif. Depuis la version : 11

      • append

        public StringBuilder append​(Object obj)
        Ajoute la représentation sous forme de chaîne deObjectl'argument. L'effet global est identique à celui de la méthode

        String.valueOf(Object)qui convertit l'argument en chaîne, puis les caractères de cette chaîne sontappended.

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

      • append

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

        Stringl'argument sont ajoutés dans l'ordre, et la longueur de cette séquence augmente de la longueur de l'argument. Sistr是null , alors les quatre caractères"null" 。

        Soit n la longueur de cette séquence de caractères avant l'exécution deappendLa longueur de cette séquence de caractères avant la méthode. Si k est inférieur à n, le caractère d'indice k dans la nouvelle séquence est égal au caractère d'indice k dans l'ancienne séquence. Sinon, il est égal à l'argument.str.

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

      • append

        public StringBuilder append​(StringBuffer sb)
        Ajoute leStringBufferspécifié à cette séquence.

        StringBufferLes caractères de l'argument sont ajoutés dans l'ordre à cette séquence, et la longueur de cette séquence augmente de la longueur de l'argument. Sisb是null ，则将四个字符"null"sont ajoutés à cette séquence.

        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 de caractères est égal au caractère à l'index k dans l'ancienne séquence de caractères. Sinon, il est égal au caractère à l'index k-n dans l'argumentsb.

        Paramètres
        sb - 要追加的 StringBufferà ajouter. Résultat une référence à cet objet.

      • append

        public StringBuilder 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'index (exclusif)end. La longueur de cette séquence augmente de la valeurend - start 。

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

        Sis是null , alors cette méthode ajoute les caractères comme si l'argument s était une séquence contenant les quatre caractères"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. Résultat Une référence à cet objet. Exceptions
        IndexOutOfBoundsException - 如果 start为负数，或 start大于 endou end大于 s.length()

      • append

        public StringBuilder append​(char[] str)
        Ajoutecharla représentation sous forme de chaîne du paramètre de tableau à cette séquence. Les caractères du paramètre de tableau sont ajoutés dans l'ordre au contenu de cette séquence. La longueur de cette séquence augmente de la longueur du paramètre.

        L'effet global est comme si le paramètre était converti en chaîne par la méthodeString.valueOf(char[])et que les caractères de cette chaîne étaient ensuite lesappendedde cette séquence de caractères.

        Paramètres
        str- Les caractères à ajouter. Résultat Une référence à cet objet.

      • append

        public StringBuilder append​(char[] str,
                            int offset,
                            int len)
        Ajoutecharla représentation sous forme de chaîne d'un sous-tableau du paramètre de tableau à cette séquence. Les

        offset开始的char阵列str.len 。

        et que les caractères de cette chaîne étaient ensuite lesString.valueOf(char[],int,int)de cette séquence de caractères.appendedParamètres

        - Les caractères à ajouter.
        str- L'index du premier
        offset à ajouter. char- Le nombre de
        len - 要追加的 char- Si c'est
        IndexOutOfBoundsException ou offset < 0ou len < 0ou offset+len > str.length

      • append

        public StringBuilder append​(boolean b)
        la représentation sous forme de chaîne du paramètrebooleanà la séquence. L'effet global est comme si

        String.valueOf(boolean)Convertit l'argument en chaîne, comme si la méthode était appelée, et les caractères de cette chaîne sont ensuite ajoutés à cette séquence de caractères.appended.

        Paramètres
        b - boolean. Résultat : une référence à cet objet.

      • append

        public StringBuilder 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 la séquence augmente

        1 。

        L'effet global est comme si l'argument était converti en chaîne par la méthodeString.valueOf(char)et que les caractères de cette chaîne étaient ensuite ajoutés à cette séquence de caractères.appended.

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

      • append

        public StringBuilder append​(int i)
        Ajouteintla représentation sous forme de chaîne de l'argument à cette séquence. L'effet global est identique à celui de la méthode

        String.valueOf(int)qui convertit l'argument en chaîne, puis les caractères de cette chaîne sontappended.

        Paramètres
        i - int. Résultat : une référence à cet objet.

      • append

        public StringBuilder append​(long lng)
        Ajoutelongla repré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 sontappended.

        Paramètres
        lng - long. Résultat : une référence à cet objet.

      • append

        public StringBuilder append​(float f)
        Ajoutefloatla représentation sous forme de chaîne de l'argument à cette séquence. L'effet global est comme si l'argument était converti en chaîne par la méthode

        String.valueOf(float)et que les caractères de cette chaîne étaient ensuite ajoutés à cette séquence de caractères.appended.

        Paramètres
        f - a float。 Résultat : une référence à cet objet.

      • append

        public StringBuilder append​(double d)
        Ajoute ladoublereprésentation sous forme de chaîne de l'argument à cette séquence. L'effet global est comme si l'argument était converti en chaîne par la méthode

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

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

      • appendCodePoint

        public StringBuilder appendCodePoint​(int codePoint)
        Ajoute lacodePointrepré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 comme si l'argument était converti en tableauCharacter.toChars(int)par la méthodechar, puis que les caractères de ce tableau étaient ajoutés àappended.

        Paramètres
        codePoint- point de code Unicode. Résultat : une référence à cet objet. Depuis la version : 1.5

      • delete

        public StringBuilder delete​(int start,
                            int end)
        Supprime les caractères d'une sous-chaîne de cette séquence. La sous-chaîne commence à l'indexstartspécifié et s'étend jusqu'au caractère à l'indexend - 1ou jusqu'à la fin de la séquence si ce caractère n'existe pas. Sistart等于end, aucun changement n'est effectué.
        Paramètres
        start- index de début, inclus.
        end- index de fin, exclusif. Résultat : cet objet. Exceptions
        StringIndexOutOfBoundsException - 如果 start为负数，大于 length() ，或大于 end.

      • deleteCharAt

        public StringBuilder deleteCharAt​(int index)
        Supprime lecharà la position spécifiée dans cette séquence. Cette séquence est raccourcie d'unchar. Remarque : si le caractère à l'index donné est un caractère supplémentaire, cette méthode ne supprime pas le caractère entier. Pour traiter correctement les caractères supplémentaires, déterminez le nombre de

        Character.charCount(thisSequence.codePointAt(index))s à supprimer en appelantchar , oùthisSequenceest cette séquence.

        Paramètres
        index - L'indice à supprimer char
        Résultat cet objet. Exception
        StringIndexOutOfBoundsException - 如果 index为负数或大于或等于 length().

      • replace

        public StringBuilder replace​(int start,
                             int end,
                             String str)
        Remplace les caractères d'une sous-chaîne de cette séquence par les caractères de laStringspécifiée. La sous-chaîne commence à l'indicestartspécifié et s'étend jusqu'au caractère à l'indiceend - 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 accueillir la chaîne spécifiée.)
        Paramètres
        start- L'indice de début, inclus.
        end- L'indice de fin, exclusif.
        str- La chaîne qui remplace le contenu précédent. Résultat cet objet. Exception
        StringIndexOutOfBoundsException - 如果 start为负数，大于 length() ，或大于 end.

      • insert

        public StringBuilder 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 à l'indiceoffset开始，并扩展len chars. Les caractères de la sous-matrice sont insérés dans la séquence à la position indiquée parindex. La longueur de la séquence augmente delen chars.
        Paramètres
        index- La position d'insertion de la sous-matrice.
        str - charLa matrice.
        offset - L'indice du premier charde la sous-matrice à insérer.
        len - Le nombre de chars de la sous-matrice à insérer. Résultat cet objet Exception
        StringIndexOutOfBoundsException - 如果 index为负数或大于 length() ，或 offsetou len为负数，或者 (offset+len)大于 str.length。

      • insert

        public StringBuilder insert​(int offset,
                            Object obj)
        VaObjectLa représentation sous forme de chaîne du paramètre est insérée dans cette séquence de caractères. L'effet global est identique à celui obtenu en passant le second paramètre à la méthode.

        String.valueOf(Object)Convertit en une chaîne de caractères identique, et le caractère de cette chaîne à l'offset spécifié dans la séquence de caractères estinserted。

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

        Paramètres
        offset- Décalage.
        obj - ObjectRésultat : une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- Si le décalage est invalide.

      • insert

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

        StringLes 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 à 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"Insérer dans cette séquence.

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

        • Si k est inférieur àoffsetalors le caractère d'index k dans l'ancienne séquence de caractères
        • Paramètresstravec l'indice k-offsetde caractères, si k n'est pas inférieur àoffset但小于offset+str.length()
        • L'index k dans l'ancienne séquence de caractères-str.length()Les caractères, si k n'est pas inférieur àoffset+str.length()

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

        Paramètres
        offset- Décalage.
        str- Une chaîne de caractères. Valeur de retour Une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- Si le décalage est invalide.

      • insert

        public StringBuilder insert​(int offset,
                            char[] str)
        Veuillez fournir le texte à traduire.charLa représentation sous forme de chaîne du paramètre tableau est insérée dans cette séquence. Les caractères du paramètre tableau sont insérés dans cette séquence.

        offsetInsère le contenu de cette séquence à la position indiquée. La longueur de la séquence augmente de celle du paramètre.

        L'effet global est comme si le second paramètre passait par la méthode.String.valueOf(char[])Convertit en une chaîne de caractères, et les caractères de cette chaîne, à l'offset indiqué, correspondent à la séquence de caractèresinserted.

        offset参数必须大于或等于0, et inférieurs ou égaux à la longueur (length) 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 StringBuilder insert​(int dstOffset,
                            CharSequence s)
        Insère laCharSequencespécifiée dans cette séquence.

        CharSequenceLes caractères du paramètre sont insérés dans cette séquence, dans l'ordre, à l'offset indiqué. 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 du paramètre s.

        Le résultat de cette méthode est exactement le même que l'appel de la méthodeinsert(dstOffset, s, 0, s.length()) de 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.

      • insert

        public StringBuilder insert​(int dstOffset,
                            CharSequence s,
                            int start,
                            int end)
        Insère laCharSequenceséquence spécifiée dans cette séquence. La sous-séquence du paramètre

        sest insérée via lesstart和endspécifiés, afin de former, à l'offset de destination indiqué dans cette séquence, un décalage vers le haut des caractères situés initialement au-dessus de cette position. La longueur de la séquence augmente deend - start 。

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

        • si k est inférieur àdstOffset, le caractère à l'index k de cette séquence
        • Paramètressle caractère à l'index k+start-dstOffsetdansdstOffset但小于dstOffset+end-start
        • mais inférieur àdstOffset+end-startsi k est supérieur ou égal à-(end-start), le caractère à l'index k de cette séquence

        dstOffset参数必须大于或等于0et inférieur ou égal à la propriété 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 des caractères，comme si le paramètre s était une séquence contenant les quatre caractères"null"的序列"null" 。

        Paramètres
        dstOffset- le décalage dans cette séquence.
        s- la séquence à insérer.
        start- l'index de début de la sous-séquence à insérer.
        end- l'index de fin de la sous-séquence à insérer. Résultat une référence à cet objet. Exceptions
        IndexOutOfBoundsException - 如果 dstOffset为负数或大于 this.length() ，或 startou end为负数，或 start大于 endou end大于 s.length()

      • insert

        public StringBuilder insert​(int offset,
                            boolean b)
        Insèrebooleanla représentation sous forme de chaîne du paramètre dans cette séquence. L'effet global est identique à celui obtenu en convertissant le second paramètre en chaîne par la méthode

        String.valueOf(boolean)，puis en insérant les caractères de cette chaîne dans cette séquence de caractères au décalage spécifié，suivi deinserted。

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

        Paramètres
        offset- le décalage.
        b - a boolean。 Résultat une référence à cet objet. Exceptions
        StringIndexOutOfBoundsException- si le décalage est invalide.

      • insert

        public StringBuilder insert​(int offset,
                            char c)
        Insèrecharla représentation sous forme de chaîne du paramètre dans cette séquence. L'effet global est identique à celui obtenu en convertissant le second paramètre en chaîne par la méthode

        String.valueOf(char)，puis en insérant les caractères de cette chaîne dans cette séquence de caractères au décalage spécifié，suivi deinserted。

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

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

      • insert

        public StringBuilder insert​(int offset,
                            int i)
        Insère la représentation sous forme de chaîne du secondintparamètre dans cette séquence. L'effet global est comme si le second paramètre était converti en chaîne par la méthode

        String.valueOf(int), et les caractères de cette chaîne étaient insérés dans la séquence de caractères à l'offset indiquéinserted.

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

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

      • insert

        public StringBuilder insert​(int offset,
                            long l)
        Insère la représentation sous forme de chaîne dulongparamètre dans cette séquence. L'effet global est exactement comme si le second paramètre était converti en chaîne par la méthode

        String.valueOf(long), et les caractères de cette chaîne étaient ensuite insérésinserteddans cette séquence de caractères à l'offset indiqué.

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

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

      • insert

        public StringBuilder insert​(int offset,
                            float f)
        Insère la représentation sous forme de chaîne dufloatparamètre dans cette séquence. L'effet global est identique à la conversion du second paramètre en chaîne par la méthode

        String.valueOf(float), et les caractères de cette chaîne sont insérés dans la séquence de caractères à l'offset indiquéinserted.

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

        Paramètres
        offset- l'offset.
        f - float。 Résultat : une référence à cet objet. Exception
        StringIndexOutOfBoundsException- si le décalage est invalide.

      • insert

        public StringBuilder insert​(int offset,
                            double d)
        Insère ladoublechaîne représentant le paramètre dans cette séquence. L'effet global est identique à la conversion du second paramètre en chaîne par la méthode

        String.valueOf(double), puis à l'insertion des caractères de cette chaîne dans la séquence de caractères au décalage indiquéinserted.

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

        Paramètres
        offset- le décalage.
        d - a double. Résultat : une référence à cet objet. Exception
        StringIndexOutOfBoundsException- si le décalage 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 plus petite 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 première occurrence de la sous-chaîne spécifiée, ou
        -1si elle n'existe pas.

      • 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 plus petite 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 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
        -1si elle n'existe pas.

      • 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 produisant à 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. Si elle n'existe pas,
        -1alors la méthode retourne -1.

      • 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. La recherche s'effectue à partir de l'index spécifié vers l'arrière. L'index retourné est la valeur maximale

        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 commencer la recherche. Résultat L'index de la dernière occurrence de la sous-chaîne spécifiée, en recherchant en arrière depuis l'index indiqué. Si aucune occurrence n'existe, la méthode renvoie
        -1.

      • reverse

        public StringBuilder reverse()
        Cette méthode remplace cette séquence de caractères par son inverse. Si la séquence contient des paires de substitution, chaque paire est traitée comme un caractère unique lors de l'inversion. L'ordre des substituts hauts et bas n'est donc jamais inversé. Soit n la longueur en caractères de cette séquence avant l'exécution de la méthodereverse(la longueur de la valeurcharn'est pas prise en compte). Alors, le caractère à l'index k de la nouvelle séquence est égal au caractère à l'index n-k-1 de l'ancienne séquence. Notez que l'inversion peut produire des paires de substitution à partir d'un substitut bas et d'un substitut haut non appariés avant l'opération. Par exemple, inverser « \uDC00 \uD800 » produit « \uD800 \uDC00 », qui est une paire de substitution valide.

        Résultat Une référence à cet objet.

      • length

        public int length()
        Retourne la longueur (nombre de caractères).
        Spécifié par :
        length在接口 CharSequence
        La longueur de la séquence de caractères actuellement représentée par cet objet.

      • capacity

        public int capacity()
        Retourne la capacité actuelle. La capacité est la quantité de stockage disponible pour les nouveaux caractères insérés. Au-delà, une allocation est effectuée.
        结果
        目前的能力

      • ensureCapacity

        public void ensureCapacity​(int minimumCapacity)
        Assure une capacité au moins égale à la valeur minimale spécifiée. Si la capacité actuelle est inférieure au paramètre, alloue un nouveau tableau interne avec une capacité plus grande. La nouvelle capacité est la plus grande des deux valeurs suivantes :
        • minimumCapacity参数。
        • le double de l'ancienne capacité, plus2 。
        SiminimumCapacityle paramètre est négatif ou nul, cette méthode ne fait rien et retourne immédiatement. Notez que les opérations suivantes 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 l'espace de 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 retournée par les appels suivants de la méthodecapacity().

      • setLength

        public void setLength​(int newLength)
        Définit la longueur de la séquence de caractères. La séquence est remplacée par une nouvelle séquence dont la longueur est spécifiée par le paramètre. Pour chaque index non négatif knewLengthLe caractère à l'index k de la nouvelle séquence est identique à celui de l'ancienne séquence si k est inférieur à la longueur de la séquence originale. Sinon, c'est le caractère nul.'\u0000'. En d'autres termes, sinewLengthle paramètre est inférieur à la longueur actuelle, la longueur devient la longueur spécifiée. Si

        newLengthle paramètre est supérieur ou égal à la longueur actuelle, des caractères nuls suffisants ( '\u0000' ) sont ajoutés pour que la longueur atteigne celle dunewLength参数。

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

        Paramètres
        newLength- nouvelle longueur Exceptions
        IndexOutOfBoundsException - 如果 newLengthparamètre est négatif.

      • charAt

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

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

        Si la valeurcharspécifiée par l'index est un surrogate, la valeur surrogate est retournée.

        Spécifié par :
        charAt在接口 CharSequence
        Paramètres
        index - l'index de la charvaleur souhaitée. Résultat : la valeur
        charà l'index spécifié. Exceptions
        IndexOutOfBoundsException - 如果 index为负数或大于或等于 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

        charspécifiée à l'index donné se trouve dans la plage des surrogates hauts, que l'index suivant est inférieur à la longueur de cette séquence et que la valeurcharà l'index suivant se trouve 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 des valeurs Résultat
        indexdu point de code du caractère à l'index Exception
        IndexOutOfBoundsException - 如果 indexl'argument est négatif ou n'est pas inférieur à la longueur de cette séquence.

      • codePointBefore

        public int codePointBefore​(int index)
        Retourne le caractère (point de code Unicode) précédant l'index spécifié. L'index fait référencecharaux valeurs (unités de code Unicode), qui vont de1àCharSequence.length(). Si

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

        Paramètres
        index- l'index après le point de code à retourner. Résultat La valeur du point de code Unicode précédant l'index donné. Exception
        IndexOutOfBoundsException - 如果 indexl'argument est inférieur à 1 ou supérieur à la longueur de cette séquence.

      • 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 spécifié et s'étend jusqu'auchar在索引endIndex - 1. La longueur de la plage de texte (enchar s) est doncendIndex-beginIndex. Les surrogates non appariés dans cette séquence comptent pour un point de code chacun.
        Paramètres
        beginIndex - l'index du premier charde la plage de texte.
        endIndex - l'index après le dernier charde la plage de texte. Résultat Le nombre de points de code Unicode dans la plage de texte spécifiée. Exception
        IndexOutOfBoundsException - 如果 beginIndex为负数，或者 endIndexest supérieur à la longueur de cette séquence, ou beginIndex大于 endIndex.

      • offsetByCodePoints

        public int offsetByCodePoints​(int index,
                              int codePointOffset)
        Retourne l'index dans cette séquence, décalé depuis l'indexindex偏移codePointOffsetPoints de code.index和codePointOffsetLes substituants non appariés dans la plage de texte donnée sont comptés comme 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-séquence à partir de indexcomporte moins de indexpoints de code, ou si codePointOffsetest négatif et si la sous-séquence avant codePointOffsetcomporte moins de la valeur absolue indexde points de code. index小于绝对值 codePointOffset代码点。

      • 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 la sous-séquence dedst的子dstet se terminent à l'index :dstBegin开始并以索引结束： 
           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 identique à l'ancienne, sauf qu'elle contient le caractèrech的字符index. 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. Exceptions
        IndexOutOfBoundsException - 如果 index为负数或大于或等于 length().

      • substring

        public String substring​(int start)
        Retourne une nouvelleStringqui contient une sous-séquence des caractères actuellement contenus dans cette séquence. 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.

      • 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 sous la forme

           sb.subSequence(begin,&nbsp;end)
        se comporte exactement comme un appel à
           sb.substring(begin,&nbsp;end)
        Cette méthode est fournie pour que cette classe implémente l'interfaceCharSequence.
        Spécifié par :
        subSequence在接口 CharSequence
        Paramètres
        start- L'index de début, inclus.
        end- L'index de fin, exclus. Résultat La sous-séquence spécifiée. Exceptions
        IndexOutOfBoundsException - 如果 startou endest négatif, si end大于 length() , ou si start大于 end

      • substring

        public String substring​(int start,
                        int end)
        Retourne une nouvelleStringqui contient une sous-séquence des caractères actuellement contenus dans cette séquence. La sous-chaîne commence à l'indexstartspé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 - 如果 startou end为负数或大于 length() , ou si start大于 end.

      • chars

        public IntStream chars()
        Retourne un flux deintpour cette séquence, avec extension zéro des valeurscharde cette séquence. Tout caractère mappé sur un surrogate code point reste non interprété. Le flux est lié à la séquence au démarrage de l'opération terminale (plus précisément, pour les séquences mutables, le splitter du flux est late-binding). Si la séquence est modifiée pendant l'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 en valeurintpuis passée au flux. Le flux est lié à la séquence au démarrage de l'opération terminale (plus précisément, pour les séquences mutables, le splitter du flux est late-binding). Si la séquence est modifiée pendant l'opération, le résultat est indéfini.

        Specified by:
        codePoints在接口 CharSequence
        Résultat Un IntStream des points de code Unicode de cette séquence Depuis la version : 9