StringBuilder.Chars[Int32] Propriété

Définition

Espace de noms:

System.Text

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

StringBuilder.cs

Obtient ou définit le caractère situé à la position de caractère spécifiée dans cette instance.

C#

public char this[int index] { get; set; }

Paramètres

index

Int32

Position du caractère.

Valeur de propriété

Char

Caractère Unicode à la position index.

Exceptions

ArgumentOutOfRangeException

index est en dehors des limites de cette instance lors de la définition d’un caractère.

IndexOutOfRangeException

index est en dehors des limites de cette instance lors de l’obtention d’un caractère.

Remarques

Le index paramètre est la position d’un caractère dans le StringBuilder. Le premier caractère de la chaîne se trouve à l’index 0. La longueur d’une chaîne est le nombre de caractères qu’elle contient. Le dernier caractère accessible d’un StringBuilder instance se trouve à l’index Length - 1.

Chars[Int32] est la propriété par défaut de la StringBuilder classe . En C#, il s’agit d’un indexeur. Cela signifie que des caractères individuels peuvent être récupérés à partir de la Chars[Int32] propriété, comme illustré dans l’exemple suivant, qui compte le nombre de caractères alphabétiques, d’espaces blancs et de ponctuation dans une chaîne.

C#

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      int nAlphabeticChars = 0;
      int nWhitespace = 0;
      int nPunctuation = 0;  
      StringBuilder sb = new StringBuilder("This is a simple sentence.");
      
      for (int ctr = 0; ctr < sb.Length; ctr++) {
         char ch = sb[ctr];
         if (Char.IsLetter(ch)) { nAlphabeticChars++;  continue; }
         if (Char.IsWhiteSpace(ch)) { nWhitespace++;  continue; }
         if (Char.IsPunctuation(ch)) nPunctuation++;  
      }    

      Console.WriteLine("The sentence '{0}' has:", sb);
      Console.WriteLine("   Alphabetic characters: {0}", nAlphabeticChars);
      Console.WriteLine("   White-space characters: {0}", nWhitespace);
      Console.WriteLine("   Punctuation characters: {0}", nPunctuation);
   }
}
// The example displays the following output:
//       The sentence 'This is a simple sentence.' has:
//          Alphabetic characters: 21
//          White-space characters: 4
//          Punctuation characters: 1

L’utilisation de l’indexation basée sur des caractères avec la propriété Chars[] peut être très lente dans les conditions suivantes :

• L’instance de StringBuilder est grande (par exemple, elle est constituée de plusieurs dizaines de milliers de caractères).
• est StringBuilder « segmenté ». Autrement dit, les appels répétés à des méthodes telles que StringBuilder.Append ont automatiquement développé la propriété de StringBuilder.Capacity l’objet et lui ont alloué de nouveaux blocs de mémoire.

Les performances sont gravement affectées, car chaque accès aux caractères doit parcourir toute la liste chaînée des blocs pour trouver la mémoire tampon correcte où indexer.

Notes

Même pour un grand objet « segmenté », StringBuilder l’utilisation de la Chars[] propriété pour l’accès basé sur un index à un ou un petit nombre de caractères a un impact négligeable sur les performances ; en général, il s’agit d’une opération O(n). Un impact significatif sur les performances se produit par contre lors de l’itération dans les caractères contenus dans l’objet StringBuilder, qui est une opération O(n^2).

Si vous rencontrez des problèmes de performances lors de l’utilisation de l’indexation basée sur des caractères avec des objets StringBuilder, vous pouvez utiliser une des solutions de contournement suivantes :

• Convertissez l’instance de StringBuilder en String en appelant la méthode ToString, puis accédez aux caractères de la chaîne.

• Copiez le contenu de l’objet StringBuilder existant dans un objet StringBuilder prédimensionné. Les performances s’améliorent, car le nouvel objet StringBuilder ne contient pas de gros blocs. Exemple :

  C#

  // sbOriginal is the existing StringBuilder object
  var sbNew = new StringBuilder(sbOriginal.ToString(), sbOriginal.Length);
  

• Définissez la capacité initiale de l’objet StringBuilder à une valeur approximativement égale à sa taille maximale attendue en appelant le constructeur StringBuilder(Int32). Notez que ceci alloue l’intégralité du bloc de mémoire, même si StringBuilder atteint rarement sa capacité maximale.

S’applique à

Voir aussi

• String