- java.lang.Object
- java.lang.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, si
zelle 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 instance
StringBuffer,然后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 un
nullargumentnullà 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 dansSortedSetou 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 StringBufferappend(boolean b)Ajoute la représentation sous forme de chaîne de l'argumentbooleanà la séquence.StringBufferappend(char c)Ajoute la représentation sous forme de chaîne de l'argumentcharà cette séquence.StringBufferappend(char[] str)Ajoute la représentation sous forme de chaîne de l'argumentchartableau à cette séquence.StringBufferappend(char[] str, int offset, int len)Ajoute la représentation sous forme de chaîne du sous-tableau de l'argumentchartableau à cette séquence.StringBufferappend(double d)Ajoute la représentation sous forme de chaîne de l'argumentdoubleà cette séquence.StringBufferappend(float f)Ajoute la représentation sous forme de chaîne de l'argumentfloatà cette séquence.StringBufferappend(int i)Ajoute la représentation sous forme de chaîne de l'argumentintà cette séquence.StringBufferappend(long lng)Ajoute la représentation sous forme de chaîne de l'argumentlongà cette séquence.StringBufferappend(CharSequence s)Ajoute leCharSequence追加到此序列。StringBufferappend(CharSequence s, int start, int end)Ajoute laCharSequenceséquence spécifiée à cette séquence.StringBufferappend(Object obj)Ajoute la représentation sous forme de chaîne de l'argumentObject.StringBufferappend(String str)Ajoute la chaîne spécifiée à cette séquence de caractères.StringBufferappend(StringBuffer sb)Ajoute leStringBuffer追加到此序列。StringBufferappendCodePoint(int codePoint)Ajoute la représentation sous forme de chaîne de l'argumentcodePointà cette séquence.intcapacity()Retourne la capacité actuelle.charcharAt(int index)Retourne la valeurchar值。IntStreamchars()Retourne un flux deintavec extension zéro sur les valeurscharde cette séquence.intcodePointAt(int index)Retourne le caractère (point de code Unicode) à l'index spécifié.intcodePointBefore(int index)Retourne le caractère (point de code Unicode) avant l'index spécifié.intcodePointCount(int beginIndex, int endIndex)Retourne le nombre de points de code Unicode dans la plage de texte spécifiée de cette séquence.IntStreamcodePoints()Retourne un flux des valeurs de points de code de cette séquence.intcompareTo(StringBuffer another)StringBufferCompare deux instances dans l'ordreStringBufferlexicographique.StringBufferdelete(int start, int end)Supprime les caractères dans une sous-chaîne de cette séquence.StringBufferdeleteCharAt(int index)Supprime le caractère à la position spécifiée dans cetchar。voidensureCapacity(int minimumCapacity)Garantit une capacité au moins égale au minimum spécifié.voidgetChars(int srcBegin, int srcEnd, char[] dst, int dstBegin)Copie les caractères de cette séquence vers le tableau de caractères cibledst。intindexOf(String str)Retourne l'index de la première occurrence de la sous-chaîne spécifiée dans la chaîne.intindexOf(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é.StringBufferinsert(int offset, boolean b)Insère la représentation sous forme de chaîne de l'argumentbooleandans cette séquence.StringBufferinsert(int offset, char c)Insère la représentation sous forme de chaîne de l'argumentchardans cette séquence.StringBufferinsert(int offset, char[] str)Insère la représentation sous forme de chaîne de l'argumentchartableau dans cette séquence.StringBufferinsert(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.StringBufferinsert(int offset, double d)Insère la représentation sous forme de chaîne de l'argumentdoubledans cette séquence.StringBufferinsert(int offset, float f)Insère la représentation sous forme de chaîne de l'argumentfloatdans cette séquence.StringBufferinsert(int offset, int i)Insère la représentation sous forme de chaîne du secondintargument dans cette séquence.StringBufferinsert(int offset, long l)Insère la représentation sous forme de chaîne de l'argumentlongdans cette séquence.StringBufferinsert(int dstOffset, CharSequence s)Insère leCharSequence插入此序列。StringBufferinsert(int dstOffset, CharSequence s, int start, int end)Insère laCharSequenceséquence spécifiée dans cette séquence.StringBufferinsert(int offset, Object obj)Insère la représentation sous forme de chaîne de l'argumentObjectdans cette séquence de caractères.StringBufferinsert(int offset, String str)Insère une chaîne dans cette séquence de caractères.intlastIndexOf(String str)Retourne l'index de la dernière occurrence de la sous-chaîne spécifiée dans la chaîne.intlastIndexOf(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é.intoffsetByCodePoints(int index, int codePointOffset)Retourne l'index dans cette séquence, à partir duquelindexDécalagecodePointOffsetPoint de code.StringBufferreplace(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.StringBufferreverse()Remplace cette séquence de caractères par son inverse.voidsetCharAt(int index, char ch)Le caractère à l'index spécifié est défini surch。voidsetLength(int newLength)Définit la longueur de la séquence de caractères.CharSequencesubSequence(int start, int end)Retourne une nouvelle séquence de caractères qui est une sous-séquence de cette séquence.Stringsubstring(int start)Retourne une nouvelleStringcontenant une sous-séquence des caractères actuellement contenus dans cette séquence de caractères.Stringsubstring(int start, int end)Retourne une nouvelleStringcontenant une sous-séquence des caractères actuellement contenus dans cette séquence.voidtrimToSize()Tente de réduire l'espace de stockage utilisé pour la séquence de caractères.-
声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
声明方法的接口 java.lang.CharSequence
chars, codePoints, length, toString
-
-
-
-
构造方法详细信息
-
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. ExceptionsNegativeArraySizeException- 如果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 laCharSequencesé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- 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 avecthis StringBuffer, tandis queStringBuffer anotherest comparé àthis StringBuffer. Paramètreanother-StringBufferleStringBuffer- à 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é, plus
2。
minimumCapacityest 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. SinewLengthl'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 ExceptionsIndexOutOfBoundsException- 如果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 valeur
charsituée à l'index spécifié est un surrogate, la valeur du surrogate est retournée.- Specified by:
charAtDans l'interfaceCharSequence- Paramètres
index- l'index de la valeurcharsouhaitée. Résultat La valeurcharà l'index spécifié. ExceptionsIndexOutOfBoundsException- 如果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 valeurcharsitué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 positionindexExceptionIndexOutOfBoundsException- 如果indexcodePointBefore
-
codePointBefore
public int codePointBefore(int index)
valeurs (unités de code Unicode), qui vont decharà1.CharSequence.length()。 Sichar在值(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. ExceptionsIndexOutOfBoundsException- 如果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 aubeginIndexet s'étend jusqu'àchar在索引endIndex - 1。 Ainsi, la longueur de la plage de texte (danschars) estendIndex-beginIndex。 Chaque agent non apparié de cette séquence compte comme un point de code.- Paramètres
beginIndex- Index du premiercharélément de la plage de texte.endIndex- Index situé après le derniercharélément de la plage de texte. Résultat Nombre de points de code Unicode dans la plage de texte spécifiée ExceptionsIndexOutOfBoundsException- 如果beginIndexest négatif, ou siendIndexest supérieur à la longueur de cette séquence, ou sibeginIndex大于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écalercodePointOffset- le décalage en points de code. Résultat : l'index dans cette séquence. ExceptionsIndexOutOfBoundsException- 如果indexest négatif ou supérieur à la longueur de cette séquence, ou sicodePointOffsetest positif et si la sous-chaîne à partir deindexcompte moins decodePointOffsetpoints de code, ou sicodePointOffset,或者codePointOffsetla sous-chaîne avantindexcompte moins que la valeur absolue de la valeur absolueindexen points de code. Depuis la version : 1.5codePointOffset代码点。- 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 dansdst. ExceptionsIndexOutOfBoundsException- 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. ExceptionIndexOutOfBoundsException- 如果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éthodeString.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éthode
append. 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'argumentStringBuffersont ajoutés dans l'ordre. Le contenuStringBufferaugmente 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 la
append方法之前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 cible
this同步,但不在源上同步(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 cible
this同步,但不在源上同步(s)。Si
s是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'argumentstartà 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 la
appendmé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。Si
s是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. ExceptionsIndexOutOfBoundsException- 如果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éthode
String.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. Lesoffset开始的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éthode
String.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 premiercharà ajouter.len- 要追加的chars à ajouter. Valeur retournée Une référence à cet objet. ExceptionsIndexOutOfBoundsException- Si l'argument estoffset < 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éthodeString.valueOf(boolean), puis que les caractères de cette chaîne étaient ajoutésappendedà cette séquence de caractères.- Paramètres
b- aboolean. 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 de1。L'effet global est exactement le même que si l'argument était converti en chaîne par la méthode
String.valueOf(char), puis que les caractères de cette chaîne étaient ajoutésappended.- Spécifié par :
append在接口Appendable- Paramètres
c- achar. 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éthodeString.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 deCharacter.charCount(codePoint).L'effet global est exactement le même que si l'argument était converti en tableau
Character.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éthodeString.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- along. 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éthodeString.valueOf(float), puis en ajoutant les caractères de cette chaîne à cette séquence de caractèresappended.- Paramètre
f- afloat. 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éthodeString.valueOf(double)Convertit les paramètres en une chaîne exactement identique, puis les caractères de cette chaîne sontappended.- Paramètre
d- adouble. 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. ExceptionsStringIndexOutOfBoundsException- 如果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 nombrecharà supprimer en appelantCharacter.charCount(thisSequence.codePointAt(index)),其中thisSequenceest cette séquence.- Paramètres
index- l'index à supprimerchar- 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. ExceptionsStringIndexOutOfBoundsException- 如果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. ExceptionsStringIndexOutOfBoundsException- 如果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 formese comporte exactement comme l'appelsb.subSequence(begin, end)Cette méthode est fournie pour que cette classe puisse implémenter l'interfacesb.substring(begin, end)CharSequence.- 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. ExceptionsIndexOutOfBoundsException- 如果start或endest négatif, siend大于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. ExceptionsStringIndexOutOfBoundsException- 如果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'àlenchars. 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 delenchars.- Paramètres
index- Position d'insertion de la sous-matrice.str- Unecharmatrice.offset- Index du premiercharde la sous-matrice à insérer.len- Nombre dechars de la sous-matrice à insérer. Résultat Cet objet ExceptionsStringIndexOutOfBoundsException- 如果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éthodeString.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. ExceptionsStringIndexOutOfBoundsException- 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'index
strk-offsetdans l'argument, si k n'est pas inférieur àoffset但小于offset+str.length() - le caractère à l'index
-str.length()koffset+str.length()
- , et inférieur ou égal à la length de cette séquence.
offsetParamètresstr- l'offset.StringIndexOutOfBoundsException- une chaîne. Résultat une référence à cet objet. Exceptions
- le caractère à l'index k dans l'ancienne séquence de caractères, si k est inférieur à
-
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 sontoffsetinsé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éthode
String.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. ExceptionsStringIndexOutOfBoundsException- 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éthode
insert(dstOffset, s, 0, s.length()) sur cet objet.Si
s是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. ExceptionsIndexOutOfBoundsException- 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'argumentsindiqué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 k
sdans 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épasser
end。Le paramètre de fin doit être supérieur ou égal à
start, et inférieur ou égal à la longueur de s.Si
s是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. AusnahmeIndexOutOfBoundsException- 如果dstOffset为负数或大于this.length(),或start或end为负数,或start大于end或end大于s.length()- 从以下版本开始:
- 1.5
- le caractère à l'index k dans cette séquence si k est inférieur à
-
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 convertissantString.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- aboolean. Résultat une référence à cet objet. ExceptionsStringIndexOutOfBoundsException- 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éthodeString.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- achar. Résultat une référence à cet objet. ExceptionsIndexOutOfBoundsException- 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éthodeString.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. ExceptionsStringIndexOutOfBoundsException- 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éthodeString.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- along. Résultat une référence à cet objet. ExceptionsStringIndexOutOfBoundsException- 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éthodeString.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- afloat. Résultat une référence à cet objet. ExceptionsStringIndexOutOfBoundsException- 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éthodeString.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- adouble. Résultat une référence à cet objet. ExceptionsStringIndexOutOfBoundsException- 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 minimalek,其中:Si aucune valeur de ce typethis.toString().startsWith(str, k)k存在,那么-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 minimalek,其中:Si aucune valeur de ce typek >= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)k存在,那么-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 valeurk,其中:Si aucune valeur de ce typethis.toString().startsWith(str, k)k存在,那么-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 valeurk,其中:Si aucune valeur de ce typek <= Math.min(fromIndex, this.length()) && this.toString().startsWith(str, k)k存在,那么-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 :
codePointsdansCharSequence- Résultat Un IntStream des points de code Unicode de cette séquence. Depuis la version : 9
-
-