Langage

String Classe

Définition

Espace de noms:
Java.Lang
Assembly:
Mono.Android.dll

La String classe représente des chaînes de caractères.

[Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)]
public sealed class String : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.ICharSequence, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>
[<Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)>]
type String = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable
Héritage
Object
JavaObject
Object
String
Attributs
RegisterAttribute
Implémente
IJavaObject IJavaPeerable ISerializable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

Remarques

La String classe représente des chaînes de caractères. Tous les littéraux de chaîne dans Java programmes, tels que "abc", sont implémentés en tant qu’instances de cette classe.

Les chaînes sont constantes ; leurs valeurs ne peuvent pas être modifiées après leur création. Les mémoires tampons de chaîne prennent en charge les chaînes mutables. Étant donné que les objets String sont immuables, ils peuvent être partagés. Par exemple : <blockquote>

String str = "abc";

</blockquote>

équivaut à : <blockquote>

char data[] = {'a', 'b', 'c'};
                String str = new String(data);

</blockquote>

Voici quelques exemples supplémentaires de la façon dont les chaînes peuvent être utilisées : <blockquote>

System.out.println("abc");
                String cde = "cde";
                System.out.println("abc" + cde);
                String c = "abc".substring(2,3);
                String d = cde.substring(1, 2);

</blockquote>

La classe String inclut des méthodes permettant d’examiner des caractères individuels de la séquence, de comparer des chaînes, de rechercher des chaînes, d’extraire des sous-chaînes et de créer une copie d’une chaîne avec tous les caractères traduits en majuscules ou en minuscules. Le mappage de cas est basé sur la version Standard Unicode spécifiée par la java.lang.Character Character classe.

Le langage Java fournit une prise en charge spéciale de l’opérateur de concaténation de chaîne (& nbsp ;+& nbsp ;), et pour la conversion d’autres objets en chaînes. Pour plus d’informations sur la concaténation et la conversion de chaînes, consultez La Java& commerce ; Spécification du langage.

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.

Représente String une chaîne au format UTF-16 dans lequel <les caractères> supplémentaires em</em> sont représentés par <>des paires< de> substitution em (voir la section Représentations de caractères Unicode dans la Character classe pour plus d’informations). Les valeurs d’index font référence aux unités de char code. Par conséquent, un caractère supplémentaire utilise deux positions dans un String.

La String classe fournit des méthodes pour traiter des points de code Unicode (c’est-à-dire des caractères), en plus de celles permettant de traiter des unités de code Unicode (c’est-à-dire des char valeurs).

Sauf indication contraire, les méthodes de comparaison de chaînes ne prennent pas en compte les paramètres régionaux. La java.text.Collator classe fournit des méthodes pour la comparaison de chaînes plus fine et sensible aux paramètres régionaux.

Ajouté dans la version 1.0.

Java documentation pour java.lang.String.

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
String()

Crée une chaîne vide.
String(Byte[], Charset)

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du java spécifié.
String(Byte[], Int32, Int32, Charset)

Construit un nouveau en String décodant le sous-narrateur spécifié d’octets à l’aide du java spécifié.
String(Byte[], Int32, Int32, Int32)
Obsolète.

Alloue une nouvelle String construction à partir d’un sous-tableau de valeurs entières 8 bits.
String(Byte[], Int32, Int32, String)

Construit un nouveau en String décodant le sous-narrateur spécifié d’octets à l’aide de l’ensemble de caractères spécifié.
String(Byte[], Int32, Int32)

Construit un nouveau en String décodant le sous-narrateur spécifié d’octets à l’aide de l’ensemble de caractères par défaut de la plateforme.
String(Byte[], Int32)
Obsolète.

Alloue un nouveau String caractère contenant des caractères construits à partir d’un tableau de valeurs entières 8 bits.
String(Byte[], String)

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du java spécifié.
String(Byte[])

Construit un nouveau en String décodant le tableau d’octets spécifié à l’aide du charset par défaut de la plateforme.
String(Char[], Int32, Int32)

Initialise cette chaîne pour contenir les s donnés char.
String(Char[])

Initialise cette chaîne pour contenir les s donnés char.
String(Int32[], Int32, Int32)

Alloue un nouveau String qui contient des caractères à partir d’un sous-narrateur de l’argument de tableau de points de code Unicode.
String(String)

Construit une nouvelle chaîne avec la même séquence de caractères que toCopy.
String(StringBuffer)

Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument de mémoire tampon de chaîne.
String(StringBuilder)

Alloue une nouvelle chaîne qui contient la séquence de caractères actuellement contenue dans l’argument du générateur de chaînes.

Propriétés

Nom Description
CaseInsensitiveOrder

Comparateur qui commande des String objets comme par compareToIgnoreCase.
Class

Retourne la classe runtime de ce Object.

(Hérité de Object)
Handle

Handle de l’instance Android sous-jacente.

(Hérité de Object)
IsBlank

Retourne true si la chaîne est vide ou contient uniquement Character#isWhitespace(int) white space des points de code, sinon false.
IsEmpty

Retourne true si, et seulement si, #length() est 0.
JniIdentityHashCode

Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité.

(Hérité de Object)
JniManagedPeerState

La String classe représente des chaînes 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 Object)
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 Object)

Méthodes

Nom Description
CharAt(Int32)

Retourne la char valeur à l’index spécifié.
Clone()

Crée et retourne une copie de cet objet.

(Hérité de Object)
CodePointAt(Int32)

Retourne le caractère (point de code Unicode) à l’index spécifié.
CodePointBefore(Int32)

Retourne le caractère (point de code Unicode) avant l’index spécifié.
CodePointCount(Int32, Int32)

Retourne le nombre de points de code Unicode dans la plage de texte spécifiée de ce String.
CompareTo(String)

Compare deux chaînes lexicographiquement.
CompareToIgnoreCase(String)

Compare deux chaînes lexicographiquement, ignorant les différences de cas.
Concat(String)

Concatène la chaîne spécifiée à la fin de cette chaîne.
Construct(JniObjectReference, JniObjectReferenceOptions)

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
Contains(ICharSequence)

Retourne true si et uniquement si cette chaîne contient la séquence spécifiée de valeurs char.
Contains(String)

Retourne true si et uniquement si cette chaîne contient la séquence spécifiée de valeurs char.
ContentEquals(ICharSequence)

Compare cette chaîne à la valeur spécifiée CharSequence.
ContentEquals(String)

Compare cette chaîne à la valeur spécifiée CharSequence.
ContentEquals(StringBuffer)

Compare cette chaîne à la valeur spécifiée StringBuffer.
CopyValueOf(Char[], Int32, Int32)

Équivalent à #valueOf(char[], int, int).
CopyValueOf(Char[])

Équivalent à #valueOf(char[]).
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()

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
EndsWith(String)

Teste si cette chaîne se termine par le suffixe spécifié.
Equals(Object)

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
Equals(Object)

Indique si un autre objet est « égal à » celui-ci.

(Hérité de Object)
EqualsIgnoreCase(String)

Compare cela String à un autre String, ignorant les considérations relatives aux cas.
Format(Locale, String, Object[])

Retourne une chaîne mise en forme à l’aide de la chaîne de format et des arguments spécifiés.
Format(String, Object[])

Retourne une chaîne mise en forme à l’aide de la chaîne de format et des arguments spécifiés.
Formatted(Object[])

Met en forme cette chaîne en remplaçant les arguments fournis.
GetBytes()

Encode cela String dans une séquence d’octets à l’aide du charset par défaut de la plateforme, stockant le résultat dans un nouveau tableau d’octets.
GetBytes(Charset)

Encode cela String dans une séquence d’octets à l’aide de java donné.
GetBytes(Int32, Int32, Byte[], Int32)
Obsolète.

Copie les caractères de cette chaîne dans le tableau d’octets de destination.
GetBytes(String)

Encode cela String dans une séquence d’octets à l’aide du charset nommé, stockant le résultat dans un nouveau tableau d’octets.
GetChars(Int32, Int32, Char[], Int32)

Copie les caractères de cette chaîne dans le tableau de caractères de destination.
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)
Indent(Int32)

Ajuste la mise en retrait de chaque ligne de cette chaîne en fonction de la valeur , et normalise les caractères d’arrêt de nligne.
IndexOf(Int32, Int32)

Retourne l’index dans cette chaîne de la première occurrence du caractère spécifié, en commençant la recherche à l’index spécifié.
IndexOf(Int32)

Retourne l’index dans cette chaîne de la première occurrence du caractère spécifié.
IndexOf(String, Int32)

Retourne l’index dans cette chaîne de la première occurrence de la sous-chaîne spécifiée, en commençant à l’index spécifié.
IndexOf(String)

Retourne l’index dans cette chaîne de la première occurrence de la sous-chaîne spécifiée.
Intern()

Retourne une représentation canonique pour l’objet string.
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)
Join(ICharSequence, ICharSequence[])

Retourne une nouvelle chaîne composée de copies de la CharSequence elements jointure avec une copie du fichier spécifié delimiter.
Join(ICharSequence, IIterable)

Retourne une nouvelle String composition composée de copies de la CharSequence elements jointure avec une copie du fichier spécifié delimiter.
Join(String, IIterable)

Retourne une nouvelle String composition composée de copies de la CharSequence elements jointure avec une copie du fichier spécifié delimiter.
Join(String, String[])

Retourne une nouvelle chaîne composée de copies de la CharSequence elements jointure avec une copie du fichier spécifié delimiter.
LastIndexOf(Int32, Int32)

Retourne l’index dans cette chaîne de la dernière occurrence du caractère spécifié, en recherchant vers l’arrière à partir de l’index spécifié.
LastIndexOf(Int32)

Retourne l’index dans cette chaîne de la dernière occurrence du caractère spécifié.
LastIndexOf(String, Int32)

Retourne l’index dans cette chaîne de la dernière occurrence de la sous-chaîne spécifiée, en recherchant vers l’arrière à partir de l’index spécifié.
LastIndexOf(String)

Retourne l’index dans cette chaîne de la dernière occurrence de la sous-chaîne spécifiée.
Length()

Retourne la longueur de cette chaîne.
Matches(String)

Indique si cette chaîne correspond ou non à l’expression régulière donnée.
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 dans ce String qui est décalé par rapport index aux points de code donnéscodePointOffset.
RegionMatches(Boolean, Int32, String, Int32, Int32)

Teste si deux régions de chaîne sont égales.
RegionMatches(Int32, String, Int32, Int32)

Teste si deux régions de chaîne sont égales.
Repeat(Int32)

Retourne une chaîne dont la valeur est la concaténation de cette chaîne à plusieurs count reprises.
Replace(Char, Char)

Retourne une chaîne résultant du remplacement de toutes les occurrences de oldChar cette chaîne par newChar.
Replace(ICharSequence, ICharSequence)

Remplace chaque sous-chaîne de cette chaîne qui correspond à la séquence cible littérale par la séquence de remplacement littérale spécifiée.
Replace(String, String)

Remplace chaque sous-chaîne de cette chaîne qui correspond à la séquence cible littérale par la séquence de remplacement littérale spécifiée.
ReplaceAll(String, String)

Remplace chaque sous-chaîne de cette chaîne qui correspond à l’expression régulière donnée par le remplacement donné.
ReplaceFirst(String, String)

Remplace la première sous-chaîne de cette chaîne qui correspond à l’expression régulière donnée par le remplacement donné.
SetHandle(IntPtr, JniHandleOwnership)

Définit la propriété Handle.

(Hérité de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
Split(String, Int32)

Fractionne cette chaîne autour des correspondances de l’expression régulière donnée.
Split(String)

Fractionne cette chaîne autour des correspondances de l’expression régulière donnée.
StartsWith(String, Int32)

Teste si la sous-chaîne de cette chaîne commençant à l’index spécifié commence par le préfixe spécifié.
StartsWith(String)

Teste si cette chaîne commence par le préfixe spécifié.
Strip()

Retourne une chaîne dont la valeur est cette chaîne, avec toutes les valeurs de début et de Character#isWhitespace(int) white space fin supprimées.
StripIndent()

Retourne une chaîne dont la valeur est cette chaîne, avec un espace blanc Character#isWhitespace(int) supprimé du début et de la fin de chaque ligne.
StripLeading()

Retourne une chaîne dont la valeur est cette chaîne, avec toutes les principales Character#isWhitespace(int) white space suppressions.
StripTrailing()

Retourne une chaîne dont la valeur est cette chaîne, avec toutes les traces Character#isWhitespace(int) white space supprimées.
SubSequence(Int32, Int32)

Retourne une séquence de caractères qui est une sous-séquence de cette séquence.
SubSequenceFormatted(Int32, Int32)

Retourne une séquence de caractères qui est une sous-séquence de cette séquence.
Substring(Int32, Int32)

Retourne une chaîne qui est une sous-chaîne de cette chaîne.
Substring(Int32)

Retourne une chaîne qui est une sous-chaîne de cette chaîne.
ToArray<T>()

Crée un tableau managé à partir de ce wrapper de tableau Java.

(Hérité de Object)
ToCharArray()

Convertit cette chaîne en tableau de caractères.
ToLowerCase()

Convertit tous les caractères dans ce String cas en minuscules à l’aide des règles des paramètres régionaux par défaut.
ToLowerCase(Locale)

Convertit tous les caractères dans ce String cas en minuscules à l’aide des règles de l’élément donné Locale.
ToString()

Convertit cette valeur en chaîne.
ToUpperCase()

Convertit tous les caractères dans ce String cas en majuscules à l’aide des règles des paramètres régionaux par défaut.
ToUpperCase(Locale)

Convertit tous les caractères dans ce String cas en majuscules à l’aide des règles de l’élément donné Locale.
Transform(IFunction)

Cette méthode permet à l’application d’une fonction de this chaîne.
TranslateEscapes()

Retourne une chaîne dont la valeur est cette chaîne, avec des séquences d’échappement traduites comme si dans un littéral de chaîne.
Trim()

Retourne une chaîne dont la valeur est cette chaîne, avec tous les espaces de début et de fin supprimés, où l’espace est défini comme n’importe quel caractère dont le point de code est inférieur ou égal à 'U+0020' (le caractère d’espace).
UnregisterFromRuntime()

Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité.

(Hérité de Object)
ValueOf(Boolean)

Retourne la représentation sous forme de chaîne de l’argument boolean .
ValueOf(Char)

Retourne la représentation sous forme de chaîne de l’argument char .
ValueOf(Char[], Int32, Int32)

Retourne la représentation sous-chaîne d’un sous-tableau spécifique de l’argument char de tableau.
ValueOf(Char[])

Retourne la représentation sous forme de chaîne de l’argument char de tableau.
ValueOf(Double)

Retourne la représentation sous forme de chaîne de l’argument double .
ValueOf(Int32)

Retourne la représentation sous forme de chaîne de l’argument int .
ValueOf(Int64)

Retourne la représentation sous forme de chaîne de l’argument long .
ValueOf(Object)

Retourne la représentation sous forme de chaîne de l’argument Object .
ValueOf(Single)

Retourne la représentation sous forme de chaîne de l’argument float .
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()

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
IJavaPeerable.Finalized()

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

La String classe représente des chaînes de caractères.

(Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

La String classe représente des chaînes de caractères.

Méthodes d’extension

Nom Description
GetJniTypeName(IJavaPeerable)

Obtient le nom JNI du type de l’instance self.
JavaAs<TResult>(IJavaPeerable)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)

La String classe représente des chaînes 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 self le typeTResult, en vérifiant que le forçage est valide côté Java.

S’applique à