StringBuffer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.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
- Attributs
- Implémente
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") la modification de la mémoire tampon de chaîne doit 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.
Java documentation pour java.lang.StringBuffer.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| 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é |
| 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
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| JniPeerMembers |
Obtient les métadonnées JNI utilisées pour appeler les membres de cet homologue Java. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de AbstractStringBuilder) |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de AbstractStringBuilder) |
Méthodes
| Nom | Description |
|---|---|
| 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[], Int32, Int32) |
Ajoute la séquence de caractères spécifiée à la fin de cette mémoire tampon. |
| Append(Char[]) |
Ajoute le tableau de caractères à 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, Int32, Int32) |
Ajouté dans 1. |
| Append(ICharSequence) |
Ajoute le spécifié |
| 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, Int32, Int32) |
Ajoute la valeur spécifiée à cette séquence de caractères. |
| Append(String) |
Ajoute la chaîne spécifiée à la fin de cette mémoire tampon. |
| Append(StringBuffer) |
Ajoute le spécifié |
| 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 |
| 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 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| Delete(Int32, Int32) |
Ajouté dans 1. |
| DeleteCharAt(Int32) |
Ajouté dans 1. |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| 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) |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| 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 |
| GetEnumerator() |
Retourne un énumérateur qui itère au sein des caractères de cette séquence. |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| IndexOf(String, Int32) |
Ajouté dans 1. |
| IndexOf(String) |
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[], Int32, Int32) |
Ajouté dans 1. |
| Insert(Int32, Char[]) |
Insère le tableau de caractères dans cette mémoire tampon au décalage spécifié. |
| 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, Int32, Int32) |
Ajouté dans 1. |
| Insert(Int32, ICharSequence) |
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, Int32, Int32) |
Ajouté dans 1. |
| Insert(Int32, String) |
Insère la chaîne dans cette mémoire tampon au décalage spécifié. |
| 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, Int32) |
Ajouté dans 1. |
| LastIndexOf(String) |
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 |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetLength(Int32) |
Définit la longueur actuelle sur une nouvelle valeur. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| SubSequence(Int32, Int32) |
Ajouté dans 1. |
| SubSequenceFormatted(Int32, Int32) |
Ajouté dans 1. |
| Substring(Int32, Int32) |
Ajouté dans 1. |
| Substring(Int32) |
Ajouté dans 1. |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne la représentation sous forme de chaîne actuelle. |
| TrimToSize() |
Ajouté dans 1. |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (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, 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) |
| 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) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IComparable.CompareTo(Object) |
Compare cette valeur à l’objet spécifié pour l’ordre. |
| IEnumerable.GetEnumerator() |
Retourne un énumérateur non générique pour les caractères de cette séquence. |
| IJavaPeerable.Disposed() |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Séquence mutable de caractères thread-safe. (Hérité de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Séquence mutable de caractères thread-safe. |
Méthodes d’extension
| Nom | Description |
|---|---|
| Append(IAppendable, String, Int32, Int32) |
Ajoute la valeur spécifiée à cette séquence de caractères. |
| Append(IAppendable, String) |
Ajoute la valeur spécifiée à cette séquence de caractères. |
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| 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. |
| SubSequence(ICharSequence, Int32, Int32) |
Retourne la sous-séquence de caractères dans la plage spécifiée. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |