String.ToCharArray Méthode

Définition

Copie les caractères de cette instance vers un tableau de caractères Unicode.Copies the characters in this instance to a Unicode character array.

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.Copies the characters in a specified substring in this instance to a Unicode character array.

ToCharArray()

Copie les caractères de cette instance vers un tableau de caractères Unicode.Copies the characters in this instance to a Unicode character array.

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.Copies the characters in a specified substring in this instance to a Unicode character array.

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.The starting position of a substring in this instance.

length
Int32

Longueur de la sous-chaîne dans cette instance.The length of the substring in this 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.A Unicode character array whose elements are the length number of characters in this instance starting from character position startIndex.

Exceptions

startIndex ou length est inférieur à zéro.startIndex or length is less than zero.

- ou --or- startIndex plus length est supérieur à la longueur de cette instance.startIndex plus length is greater than the length of this instance.

Exemples

L’exemple suivant convertit une sous-chaîne d’une chaîne en un tableau de caractères, puis énumère et affiche les éléments du tableau.The following example converts a substring within a string to an array of characters, then enumerates and displays the elements of the array.

// 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)
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.This method copies the characters in a portion of a string to a character array. Pour créer une chaîne à partir d’une plage de caractères dans un tableau de caractères, appelez le constructeur String(Char[], Int32, Int32).To create a string from a range of characters in a character array, call the String(Char[], Int32, Int32) constructor.

Le paramètre startIndex est de base zéro.The startIndex parameter is zero-based. Autrement dit, l’index du premier caractère de l’instance de chaîne est égal à zéro.That is, the index of the first character in the string instance is zero.

Si length est égal à zéro, le tableau retourné est vide et sa longueur est égale à zéro.If length is zero, the returned array is empty and has a zero length. Si cette instance est null ou une chaîne vide (""), le tableau retourné est vide et sa longueur est égale à zéro.If this instance is null or an empty string (""), the returned array is empty and has a zero length.

Pour créer un tableau d’octets qui contient les caractères encodés dans une partie d’une chaîne, instanciez l’objet Encoding approprié et appelez sa méthode GetBytes(String, Int32, Int32, Byte[], Int32).To create a byte array that contains the encoded characters in a portion of a string, instantiate the appropriate Encoding object and call its GetBytes(String, Int32, Int32, Byte[], Int32) method. Parmi les encodages standard disponibles dans .NET, citons :Some of the standard encodings available in .NET include:

EncodageEncoding ObjectObject
nonASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Pour plus d’informations, consultez encodage de caractères dans .net.For more information, see Character Encoding in .NET.

Voir aussi

ToCharArray()

Copie les caractères de cette instance vers un tableau de caractères Unicode.Copies the characters in this instance to a Unicode character array.

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.A Unicode character array whose elements are the individual characters of this instance. Si cette instance est une chaîne vide, le tableau retourné est vide et sa longueur est égale à zéro.If this instance is an empty string, the returned array is empty and has a zero length.

Exemples

L’exemple suivant appelle la méthode ToCharArray pour extraire les caractères d’une chaîne en un tableau de caractères.The following example calls the ToCharArray method to extract the characters in a string to a character array. Il affiche ensuite la chaîne d’origine et les éléments dans le tableau.It then displays the original string and the elements in the array.

using System;

public class Example
{
   public static void Main()
   {
      String s = "AaBbCcDd";
      var 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
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

L’exemple suivant définit une chaîne contenant les caractères qui servent de délimiteurs dans une chaîne délimitée.The following example defines a string containing the characters that serve as delimiters in a delimited string. Il appelle ensuite la méthode ToCharArray pour créer un tableau de caractères qui peut être passé à la méthode Split(Char[]) pour séparer la chaîne délimitée en ses sous-chaînes individuelles.It then calls the ToCharArray method to create a character array that can be passed to the Split(Char[]) method to separate the delimited string into its individual substrings.

using namespace System;
using namespace System::Collections;
int main()
{
   String^ delimStr = " ,.:";
   array<Char>^delimiter = delimStr->ToCharArray();
   String^ words = "one two,three:four.";
   array<String^>^split = nullptr;
   Console::WriteLine( "The delimiters are -{0}-", delimStr );
   for ( int x = 1; x <= 5; x++ )
   {
      split = words->Split( delimiter, x );
      Console::WriteLine( "\ncount = {0, 2} ..............", x );
      IEnumerator^ myEnum = split->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         String^ s = safe_cast<String^>(myEnum->Current);
         Console::WriteLine( "-{0}-", s );
      }

   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
using System;

public class Example
{
   public static void Main() 
   {
      string delimStr = " ,.:";
      char [] delimiter = delimStr.ToCharArray();
      string words = "one two,three:four.";
      string [] split = null;

      Console.WriteLine("The delimiters are -{0}-", delimStr);
      for (int x = 1; x <= 5; x++) {
         split = words.Split(delimiter, x);
         Console.WriteLine("\ncount = {0,2} ..............", x);
         foreach (var s in split) {
             Console.WriteLine("-{0}-", s);
         }
      }
   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
Public Class StringSplit2
   Public Shared Sub Main()
      
      Dim delimStr As String = " ,.:"
      Dim delimiter As Char() = delimStr.ToCharArray()
      Dim words As String = "one two,three:four."
      Dim split As String() = Nothing
      
      Console.WriteLine("The delimiters are -{0}-", delimStr)
      Dim x As Integer
      For x = 1 To 5
         split = words.Split(delimiter, x)
         Console.WriteLine(ControlChars.Cr + "count = {0,2} ..............", x)
         Dim s As String
         For Each s In  split
            Console.WriteLine("-{0}-", s)
         Next s
      Next x
   End Sub 
End Class 
' The example displays the following output:
'       The delimiters are - ,.:-
'       count =  1 ..............
'       -one two,three:four.-
'       count =  2 ..............
'       -one-
'       -two,three:four.-
'       count =  3 ..............
'       -one-
'       -two-
'       -three:four.-
'       count =  4 ..............
'       -one-
'       -two-
'       -three-
'       -four.-
'       count =  5 ..............
'       -one-
'       -two-
'       -three-
'       -four-
'       --

Remarques

Cette méthode copie chaque caractère (c’est-à-dire, chaque objet Char) d’une chaîne dans un tableau de caractères.This method copies each character (that is, each Char object) in a string to a character array. 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.The first character copied is at index zero of the returned character array; the last character copied is at index Array.Length - 1.

Pour créer une chaîne à partir des caractères d’un tableau de caractères, appelez le constructeur String(Char[]).To create a string from the characters in a character array, call the String(Char[]) constructor.

Pour créer un tableau d’octets qui contient les caractères encodés dans une chaîne, instanciez l’objet Encoding approprié et appelez sa méthode Encoding.GetBytes(String).To create a byte array that contains the encoded characters in a string, instantiate the appropriate Encoding object and call its Encoding.GetBytes(String) method. Voici quelques-uns des encodages standard disponibles dans .NET :Some of the standard encodings available in .NET include the following:

EncodageEncoding ObjectObject
nonASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

Pour plus d’informations, consultez encodage de caractères dans .net.For more information, see Character Encoding in .NET.

Voir aussi

S’applique à