String.ToCharArray Méthode

Définition

Copie les caractères de cette instance vers un tableau de caractères Unicode.

Surcharges

ToCharArray(Int32, Int32)

Copie les caractères d'une sous-chaîne spécifiée de cette instance vers un tableau de caractères Unicode.

ToCharArray()

Copie les caractères de cette instance vers un tableau de caractères Unicode.

ToCharArray(Int32, Int32)

Copie les caractères d'une sous-chaîne spécifiée de cette instance vers un tableau de caractères Unicode.

public:
 cli::array <char> ^ ToCharArray(int startIndex, int length);
public char[] ToCharArray (int startIndex, int length);
member this.ToCharArray : int * int -> char[]
Public Function ToCharArray (startIndex As Integer, length As Integer) As Char()

Paramètres

startIndex
Int32

Position de départ d'une sous-chaîne dans cette instance.

length
Int32

Longueur de la sous-chaîne dans cette instance.

Retours

Char[]

Tableau de caractères Unicode dont les éléments sont le nombre de caractères length de cette instance à partir de la position de caractère startIndex.

Exceptions

startIndex ou length est inférieur à zéro.

- ou -

startIndex plus length est supérieur à la longueur de cette instance.

Exemples

L’exemple suivant convertit une sous-chaîne dans une chaîne en tableau de caractères, puis énumère et affiche les éléments du tableau.

// Sample for String::ToCharArray(Int32, Int32)
using namespace System;
using namespace System::Collections;
int main()
{
   String^ str = "012wxyz789";
   array<Char>^arr;
   arr = str->ToCharArray( 3, 4 );
   Console::Write( "The letters in '{0}' are: '", str );
   Console::Write( arr );
   Console::WriteLine( "'" );
   Console::WriteLine( "Each letter in '{0}' is:", str );
   IEnumerator^ myEnum = arr->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c =  safe_cast<Char>(myEnum->Current);
      Console::WriteLine( c );
   }
}

/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/
// Sample for String.ToCharArray(Int32, Int32)
using System;

class Sample {
    public static void Main() {
    string str = "012wxyz789";
    char[] arr;

    arr = str.ToCharArray(3, 4);
    Console.Write("The letters in '{0}' are: '", str);
    Console.Write(arr);
    Console.WriteLine("'");
    Console.WriteLine("Each letter in '{0}' is:", str);
    foreach (char c in arr)
        Console.WriteLine(c);
    }
}
/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/
// Sample for String.ToCharArray(Int32, Int32)
let str = "012wxyz789"

let arr = str.ToCharArray(3, 4)
printf $"The letters in '{str}' are: '"
printf $"{arr}"
printfn "'"
printfn $"Each letter in '{str}' is:"
for c in arr do
    printfn $"{c}"
(*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*)
' Sample for String.ToCharArray(Int32, Int32)
Class Sample
   
   Public Shared Sub Main()
      Dim str As String = "012wxyz789"
      Dim arr() As Char
      
      arr = str.ToCharArray(3, 4)
      Console.Write("The letters in '{0}' are: '", str)
      Console.Write(arr)
      Console.WriteLine("'")
      Console.WriteLine("Each letter in '{0}' is:", str)
      Dim c As Char
      For Each c In arr
         Console.WriteLine(c)
      Next c
   End Sub
End Class
'
'This example produces the following results:
'The letters in '012wxyz789' are: 'wxyz'
'Each letter in '012wxyz789' is:
'w
'x
'y
'z
'

Remarques

Cette méthode copie les caractères d’une partie d’une chaîne dans un tableau de caractères. Pour créer une chaîne à partir d’une plage de caractères dans un tableau de caractères, appelez le String(Char[], Int32, Int32) constructeur .

Le startIndex paramètre est de base zéro. Autrement dit, l’index du premier caractère de la chaîne instance est égal à zéro.

Si length est zéro, le tableau retourné est vide et a une longueur nulle. Si cette instance est null ou une chaîne vide («  »), le tableau retourné est vide et a une longueur nulle.

Pour créer un tableau d’octets qui contient les caractères codés dans une partie d’une chaîne, instanciez l’objet approprié Encoding et appelez sa GetBytes(String, Int32, Int32, Byte[], Int32) méthode. Voici quelques-uns des encodages standard disponibles dans .NET :

Encodage Object
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Pour plus d’informations, consultez Encodage de caractères dans .NET.

Voir aussi

S’applique à

ToCharArray()

Copie les caractères de cette instance vers un tableau de caractères Unicode.

public:
 cli::array <char> ^ ToCharArray();
public char[] ToCharArray ();
member this.ToCharArray : unit -> char[]
Public Function ToCharArray () As Char()

Retours

Char[]

Tableau de caractères Unicode dont les éléments sont les caractères individuels de cette instance. Si cette instance est une chaîne vide, le tableau retourné est vide et sa longueur est égale à zéro.

Exemples

L’exemple suivant appelle la ToCharArray méthode pour extraire les caractères d’une chaîne dans un tableau de caractères. Il affiche ensuite la chaîne d’origine et les éléments dans le tableau.

using System;

public class Example
{
   public static void Main()
   {
      string s = "AaBbCcDd";
      char[] chars = s.ToCharArray();
      Console.WriteLine("Original string: {0}", s);
      Console.WriteLine("Character array:");
      for (int ctr = 0; ctr < chars.Length; ctr++)
      {
         Console.WriteLine("   {0}: {1}", ctr, chars[ctr]);
      }
   }
}

// The example displays the following output:
//     Original string: AaBbCcDd
//     Character array:
//        0: A
//        1: a
//        2: B
//        3: b
//        4: C
//        5: c
//        6: D
//        7: d
let s = "AaBbCcDd"
let chars = s.ToCharArray()
printfn $"Original string: {s}"
printfn "Character array:"
for i = 0 to chars.Length - 1 do
    printfn $"   {i}: {chars[i]}"

// The example displays the following output:
//     Original string: AaBbCcDd
//     Character array:
//        0: A
//        1: a
//        2: B
//        3: b
//        4: C
//        5: c
//        6: D
//        7: d
Module Example
   Public Sub Main()
      Dim s As String = "AaBbCcDd"
      Dim chars() = s.ToCharArray()
      Console.WriteLine("Original string: {0}", s)
      Console.WriteLine("Character array:")
      For ctr = 0 to chars.Length - 1
         Console.WriteLine("   {0}: {1}", ctr, chars(ctr))
      Next
   End Sub
End Module
' The example displays the following output:
'     Original string: AaBbCcDd
'     Character array:
'        0: A
'        1: a
'        2: B
'        3: b
'        4: C
'        5: c
'        6: D
'        7: d

Remarques

Cette méthode copie chaque caractère (c’est-à-dire chaque Char objet) d’une chaîne dans un tableau de caractères. Le premier caractère copié se trouve à l’index zéro du tableau de caractères retourné ; le dernier caractère copié se trouve à l’index Array.Length - 1.

Pour créer une chaîne à partir des caractères d’un tableau de caractères, appelez le String(Char[]) constructeur .

Pour créer un tableau d’octets qui contient les caractères encodés dans une chaîne, instanciez l’objet approprié Encoding et appelez sa Encoding.GetBytes(String) méthode. Voici quelques-uns des encodages standard disponibles dans .NET :

Encodage Object
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Pour plus d’informations, consultez Encodage de caractères dans .NET.

Voir aussi

S’applique à