StringBuilder 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.
[Android.Runtime.Register("java/lang/StringBuilder", DoNotGenerateAcw=true)]
public sealed class StringBuilder : Java.Lang.AbstractStringBuilder, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>
[<Android.Runtime.Register("java/lang/StringBuilder", DoNotGenerateAcw=true)>]
type StringBuilder = 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. Cette classe fournit une API compatible avec StringBuffer, mais sans garantie de synchronisation. Cette classe est conçue pour être utilisée comme remplacement de dépôt pour StringBuffer les emplacements où la mémoire tampon de chaîne était utilisée par un thread unique (comme c’est généralement le cas). Dans la mesure du possible, il est recommandé que cette classe soit utilisée en préférence car StringBuffer elle sera plus rapide dans la plupart des implémentations.
Les opérations principales sur un StringBuilder 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 le générateur de chaînes. La append méthode ajoute toujours ces caractères à la fin du générateur ; la insert méthode ajoute les caractères à un point spécifié.
Par exemple, si z elle fait référence à un objet de générateur de chaînes dont le contenu actuel est «start », l’appel z.append("le") de méthode entraîne la présence du générateur de chaînes «startle », alors qu’il z.insert(4, "le") modifie le générateur de chaînes pour qu’il contienne «starlet ».
En général, si sb fait référence à une instance d’un StringBuilder, a sb.append(x) le même effet que sb.insert(sb.length(), x).
Chaque générateur de chaînes a une capacité. Tant que la longueur de la séquence de caractères contenue dans le générateur de chaînes ne dépasse pas la capacité, il n’est pas nécessaire d’allouer une nouvelle mémoire tampon interne. Si la mémoire tampon interne dépasse, elle est automatiquement agrandie.
Les instances de StringBuilder ne sont pas sécurisées pour une utilisation par plusieurs threads. Si cette synchronisation est requise, il est recommandé d’utiliser java.lang.StringBuffer cette synchronisation.
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.
Ajouté à la version 1.5.
Java documentation pour java.lang.StringBuilder.
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 |
|---|---|
| StringBuilder() |
Construit un générateur de chaînes sans caractères et une capacité initiale de 16 caractères. |
| StringBuilder(ICharSequence) |
Construit un générateur de chaînes qui contient les mêmes caractères que le générateur de chaînes spécifié |
| StringBuilder(Int32) |
Construit un générateur de chaînes sans caractères et une capacité initiale spécifiée par l’argument |
| StringBuilder(String) |
Construit un générateur de chaînes initialisé au 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. (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 de la valeur spécifiée |
| Append(Char) |
Ajoute la représentation sous forme de chaîne de la valeur spécifiée |
| Append(Char[], Int32, Int32) |
Ajoute la représentation sous-forme de chaîne du sous-ensemble spécifié du |
| Append(Char[]) |
Ajoute la représentation sous forme de chaîne du |
| Append(Double) |
Ajoute la représentation sous forme de chaîne de la valeur spécifiée |
| Append(ICharSequence, Int32, Int32) |
Ajoute la représentation sous-chaîne de la sous-séquence spécifiée du |
| Append(ICharSequence) |
Ajoute la représentation sous forme de chaîne du |
| Append(Int32) |
Ajoute la représentation sous forme de chaîne de la valeur spécifiée |
| Append(Int64) |
Ajoute la représentation sous forme de chaîne de la valeur spécifiée |
| Append(Object) |
Ajoute la représentation sous forme de chaîne du |
| Append(Single) |
Ajoute la représentation sous forme de chaîne de la valeur spécifiée |
| Append(String, Int32, Int32) |
Ajoute la valeur spécifiée à cette séquence de caractères. |
| Append(String) |
Ajoute le contenu de la chaîne spécifiée. |
| 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) |
Récupère la valeur du point de code Unicode à l’adresse |
| CodePointBefore(Int32) |
Récupère la valeur de point de code Unicode qui précède le |
| CodePointCount(Int32, Int32) |
Calcule le nombre de points de code Unicode entre |
| CompareTo(StringBuilder) |
Compare deux |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Séquence mutable de caractères. (Hérité de JavaObject) |
| Delete(Int32, Int32) |
Supprime une séquence de caractères spécifiée par |
| DeleteCharAt(Int32) |
Supprime le caractère à l’index spécifié. déplace les caractères restants vers la gauche. |
| 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. (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. (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 demandée de caractères en |
| 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) |
Recherche l’index du caractère spécifié. |
| IndexOf(String) |
Recherche le premier index du caractère spécifié. |
| Insert(Int32, Boolean) |
Insère la représentation sous forme de chaîne de la valeur spécifiée |
| Insert(Int32, Char) |
Insère la représentation sous forme de chaîne de la valeur spécifiée |
| Insert(Int32, Char[], Int32, Int32) |
Insère la représentation sous-chaîne de la sous-file d’attente spécifiée au |
| Insert(Int32, Char[]) |
Insère la représentation sous forme de chaîne du spécifié |
| Insert(Int32, Double) |
Insère la représentation sous forme de chaîne de la valeur spécifiée |
| Insert(Int32, ICharSequence, Int32, Int32) |
Insère la représentation sous-chaîne de la sous-file d’attente spécifiée au |
| Insert(Int32, ICharSequence) |
Insère la représentation sous forme de chaîne du spécifié |
| Insert(Int32, Int32) |
Insère la représentation sous forme de chaîne de la valeur spécifiée |
| Insert(Int32, Int64) |
Insère la représentation sous forme de chaîne de la valeur spécifiée |
| Insert(Int32, Object) |
Insère la représentation sous forme de chaîne du spécifié |
| Insert(Int32, Single) |
Insère la représentation sous forme de chaîne de la valeur spécifiée |
| Insert(Int32, String, Int32, Int32) |
Insère la valeur spécifiée dans cette séquence de caractères. |
| Insert(Int32, String) |
Insère la chaîne spécifiée au niveau 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) |
Recherche l’index du caractère spécifié. |
| LastIndexOf(String) |
Recherche le dernier index du caractère spécifié. |
| 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) |
Retourne l’index qui est des points de code de décalage |
| Replace(Int32, Int32, String) |
Remplace la sous-file d’attente spécifiée dans ce générateur par la chaîne spécifiée. |
| Reverse() |
Inverse l’ordre des caractères dans ce générateur. |
| 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. (Hérité de JavaObject) |
| SubSequence(Int32, Int32) |
Retourne la sous-séquence de caractères dans la plage spécifiée. |
| SubSequenceFormatted(Int32, Int32) |
Retourne une |
| Substring(Int32, Int32) |
Retourne la valeur String de la sous-file d’attente de l’index |
| Substring(Int32) |
Retourne la valeur String de la sous-file d’attente de l’index |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne le contenu de ce générateur. |
| TrimToSize() |
Supprime toute capacité supplémentaire au-delà de la longueur actuelle. |
| 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. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Séquence mutable de caractères. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Séquence mutable de caractères. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Séquence mutable de caractères. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Séquence mutable de caractères. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Séquence mutable de caractères. (Hérité de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Séquence mutable de caractères. |
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. |
| 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 |