StringBuffer Classe

Définition

Espace de noms:

Java.Lang

Assembly:

Mono.Android.dll

Séquence mutable de caractères thread-safe.

[Android.Runtime.Register("java/lang/StringBuffer", DoNotGenerateAcw=true)]
public sealed class StringBuffer : Java.Lang.AbstractStringBuilder, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>

[<Android.Runtime.Register("java/lang/StringBuffer", DoNotGenerateAcw=true)>]
type StringBuffer = class
    inherit AbstractStringBuilder
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IAppendable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable

Héritage

Object

Object

AbstractStringBuilder

StringBuffer

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable ISerializable IAppendable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

Remarques

Séquence mutable de caractères thread-safe. Une mémoire tampon de chaîne est semblable à un String, mais peut être modifiée. À tout moment, il contient une séquence particulière de caractères, mais la longueur et le contenu de la séquence peuvent être modifiés par le biais de certains appels de méthode.

Les mémoires tampons de chaîne sont sécurisées pour une utilisation par plusieurs threads. Les méthodes sont synchronisées si nécessaire afin que toutes les opérations sur une instance particulière se comportent comme si elles se produisent dans un ordre de série cohérent avec l’ordre des appels de méthode effectués par chacun des threads individuels impliqués.

Les opérations principales sur un StringBuffer sont les append méthodes et insert les méthodes, qui sont surchargées afin d’accepter des données de n’importe quel type. Chacune convertit efficacement une référence donnée en chaîne, puis ajoute ou insère les caractères de cette chaîne dans la mémoire tampon de chaîne. La append méthode ajoute toujours ces caractères à la fin de la mémoire tampon ; la insert méthode ajoute les caractères à un point spécifié.

Par exemple, si z elle fait référence à un objet de mémoire tampon de chaîne dont le contenu actuel est "start", l’appel z.append("le") de méthode entraîne le conteneur "startle"de la mémoire tampon de chaîne, tandis que z.insert(4, "le") modifierait la mémoire tampon de chaîne à contenir "starlet".

En général, si sb fait référence à une instance d’un StringBuffer, a sb.append(x) le même effet que sb.insert(sb.length(), x).

Chaque fois qu’une opération se produit impliquant une séquence source (par exemple, l’ajout ou l’insertion à partir d’une séquence source), cette classe se synchronise uniquement sur la mémoire tampon de chaîne effectuant l’opération, et non sur la source. Notez que, bien qu’il StringBuffer soit conçu pour être sécurisé à utiliser simultanément à partir de plusieurs threads, si le constructeur ou l’opération appendinsert est passé une séquence source partagée entre les threads, le code appelant doit s’assurer que l’opération a une vue cohérente et immuable de la séquence source pendant la durée de l’opération. Cela peut être satisfait par l’appelant qui contient un verrou pendant l’appel de l’opération, à l’aide d’une séquence source immuable ou en ne partageant pas la séquence source entre les threads.

Chaque mémoire tampon de chaîne a une capacité. Tant que la longueur de la séquence de caractères contenue dans la mémoire tampon de chaîne ne dépasse pas la capacité, il n’est pas nécessaire d’allouer un nouveau tableau de mémoires tampons interne. Si la mémoire tampon interne dépasse, elle est automatiquement agrandie.

Sauf indication contraire, le passage d’un null argument à un constructeur ou à une méthode dans cette classe entraîne la levée d’un NullPointerException argument.

Depuis la version JDK 5, cette classe a été complétée par une classe équivalente conçue pour être utilisée par un thread unique. StringBuilder La StringBuilder classe doit généralement être utilisée en préférence pour celle-ci, car elle prend en charge toutes les mêmes opérations, mais elle est plus rapide, car elle n’effectue aucune synchronisation.

Ajouté dans la version 1.0.

Documentation Java pour java.lang.StringBuffer.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Constructeurs

StringBuffer()	Construit une mémoire tampon de chaîne sans caractères et une capacité initiale de 16 caractères.
StringBuffer(ICharSequence)	Construit une mémoire tampon de chaîne qui contient les mêmes caractères que le fichier spécifié CharSequence.
StringBuffer(Int32)	Construit une mémoire tampon de chaîne sans caractères et la capacité initiale spécifiée.
StringBuffer(String)	Construit une mémoire tampon de chaîne initialisée dans le contenu de la chaîne spécifiée.

Propriétés

Class	Retourne la classe runtime de ce Object. (Hérité de Object)
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
JniIdentityHashCode	Séquence mutable de caractères thread-safe. (Hérité de Object)
JniPeerMembers	Séquence mutable de caractères thread-safe.
PeerReference	Séquence mutable de caractères thread-safe. (Hérité de Object)
ThresholdClass	Séquence mutable de caractères thread-safe. (Hérité de AbstractStringBuilder)
ThresholdType	Séquence mutable de caractères thread-safe. (Hérité de AbstractStringBuilder)

Méthodes

Append(Boolean)	Ajoute la représentation sous forme de chaîne du booléen spécifié à la fin de ce StringBuffer.
Append(Char)	Ajoute le caractère spécifié à la fin de cette mémoire tampon.
Append(Char[])	Ajoute le tableau de caractères à la fin de cette mémoire tampon.
Append(Char[], Int32, Int32)	Ajoute la séquence de caractères spécifiée à la fin de cette mémoire tampon.
Append(Double)	Ajoute la représentation sous forme de chaîne du double spécifié à la fin de ce StringBuffer.
Append(ICharSequence)	Ajoute le spécifié CharSequence à cette séquence.
Append(ICharSequence, Int32, Int32)	Ajouté dans 1.
Append(Int32)	Ajoute la représentation sous forme de chaîne de l’entier spécifié à la fin de ce StringBuffer.
Append(Int64)	Ajoute la représentation sous forme de chaîne du long spécifié à la fin de ce StringBuffer.
Append(Object)	Ajoute la représentation sous forme de chaîne de l’objet spécifié à la fin de ce StringBuffer.
Append(Single)	Ajoute la représentation sous forme de chaîne du float spécifié à la fin de ce StringBuffer.
Append(String)	Ajoute la chaîne spécifiée à la fin de cette mémoire tampon.
Append(String, Int32, Int32)	Séquence mutable de caractères thread-safe.
Append(StringBuffer)	Ajoute le spécifié StringBuffer à cette séquence.
AppendCodePoint(Int32)	Ajouté dans 1.
Capacity()	Retourne le nombre de caractères qui peuvent être conservés sans augmenter.
CharAt(Int32)	Retourne le caractère à l’adresse index.
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
CodePointAt(Int32)	Ajouté dans 1.
CodePointBefore(Int32)	Ajouté dans 1.
CodePointCount(Int32, Int32)	Ajouté dans 1.
CompareTo(StringBuffer)	Compare deux StringBuffer instances lexicographiquement.
Delete(Int32, Int32)	Ajouté dans 1.
DeleteCharAt(Int32)	Ajouté dans 1.
Dispose()	Séquence mutable de caractères thread-safe. (Hérité de Object)
Dispose(Boolean)	Séquence mutable de caractères thread-safe. (Hérité de Object)
EnsureCapacity(Int32)	Garantit que cet objet dispose d’une capacité minimale disponible avant de demander l’agrandissement de la mémoire tampon interne.
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetChars(Int32, Int32, Char[], Int32)	Copie la séquence de caractères demandée au démarrage passé à l’adresse char[]idx.
GetEnumerator()	Séquence mutable de caractères thread-safe.
GetHashCode()	Retourne une valeur de code de hachage pour l'objet. (Hérité de Object)
IndexOf(String)	Ajouté dans 1.
IndexOf(String, Int32)	Ajouté dans 1.
Insert(Int32, Boolean)	Insère la représentation sous forme de chaîne du booléen spécifié dans cette mémoire tampon au décalage spécifié.
Insert(Int32, Char)	Insère le caractère dans cette mémoire tampon au décalage spécifié.
Insert(Int32, Char[])	Insère le tableau de caractères dans cette mémoire tampon au décalage spécifié.
Insert(Int32, Char[], Int32, Int32)	Ajouté dans 1.
Insert(Int32, Double)	Insère la représentation sous forme de chaîne du tampon spécifié double à l’offset spécifié.
Insert(Int32, ICharSequence)	Ajouté dans 1.
Insert(Int32, ICharSequence, Int32, Int32)	Ajouté dans 1.
Insert(Int32, Int32)	Insère la représentation sous forme de chaîne de l’entier spécifié dans cette mémoire tampon au décalage spécifié.
Insert(Int32, Int64)	Insère la représentation sous forme de chaîne du long spécifié dans cette mémoire tampon au décalage spécifié.
Insert(Int32, Object)	Insère la représentation sous forme de chaîne de l’objet spécifié dans cette mémoire tampon au décalage spécifié.
Insert(Int32, Single)	Insère la représentation sous forme de chaîne du float spécifié dans cette mémoire tampon au décalage spécifié.
Insert(Int32, String)	Insère la chaîne dans cette mémoire tampon au décalage spécifié.
Insert(Int32, String, Int32, Int32)	Ajouté dans 1.
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
LastIndexOf(String)	Ajouté dans 1.
LastIndexOf(String, Int32)	Ajouté dans 1.
Length()	Longueur actuelle.
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
OffsetByCodePoints(Int32, Int32)	Ajouté dans 1.
Replace(Int32, Int32, String)	Ajouté dans 1.
Reverse()	Ajouté dans 1.
SetCharAt(Int32, Char)	Définit le caractère au niveau du index.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetLength(Int32)	Définit la longueur actuelle sur une nouvelle valeur.
SubSequence(Int32, Int32)	Ajouté dans 1.
SubSequenceFormatted(Int32, Int32)	Ajouté dans 1.
Substring(Int32)	Ajouté dans 1.
Substring(Int32, Int32)	Ajouté dans 1.
ToArray<T>()	Séquence mutable de caractères thread-safe. (Hérité de Object)
ToString()	Retourne la représentation sous forme de chaîne actuelle.
TrimToSize()	Ajouté dans 1.
UnregisterFromRuntime()	Séquence mutable de caractères thread-safe. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Implémentations d’interfaces explicites

IComparable.CompareTo(Object)	Séquence mutable de caractères thread-safe.
IEnumerable.GetEnumerator()	Séquence mutable de caractères thread-safe.
IJavaPeerable.Disposed()	Séquence mutable de caractères thread-safe. (Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()	Séquence mutable de caractères thread-safe. (Hérité de Object)
IJavaPeerable.Finalized()	Séquence mutable de caractères thread-safe. (Hérité de Object)
IJavaPeerable.JniManagedPeerState	Séquence mutable de caractères thread-safe. (Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Séquence mutable de caractères thread-safe. (Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Séquence mutable de caractères thread-safe. (Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Séquence mutable de caractères thread-safe. (Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Séquence mutable de caractères thread-safe.
GetJniTypeName(IJavaPeerable)	Séquence mutable de caractères thread-safe.
Append(IAppendable, String)	Séquence mutable de caractères thread-safe.
Append(IAppendable, String, Int32, Int32)	Séquence mutable de caractères thread-safe.
SubSequence(ICharSequence, Int32, Int32)	Séquence mutable de caractères thread-safe.