String.ToCharArray Methode

Bron:

String.cs

Bron:

String.cs

Bron:

String.cs

Bron:

String.cs

Bron:

String.cs

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

Parameters

Retouren

Een Unicode-tekenmatrix waarvan de elementen het length aantal tekens in dit exemplaar zijn, beginnend vanaf de tekenpositie startIndex.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een subtekenreeks binnen een tekenreeks geconverteerd naar een matrix met tekens, waarna de elementen van de matrix worden opgesomd en weergegeven.

// 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
'

Opmerkingen

Met deze methode worden de tekens in een deel van een tekenreeks gekopieerd naar een tekenmatrix. Als u een tekenreeks wilt maken op basis van een reeks tekens in een tekenmatrix, roept u de String(Char[], Int32, Int32) constructor aan.

De startIndex parameter is gebaseerd op nul. Dat wil gezegd: de index van het eerste teken in het tekenreeksexemplaren is nul.

Als length nul is, is de geretourneerde matrix leeg en heeft de lengte nul. Als dit exemplaar of null een lege tekenreeks (""), de geretourneerde matrix leeg is en een lengte van nul heeft.

Als u een bytematrix wilt maken die de gecodeerde tekens in een deel van een tekenreeks bevat, maakt u een instantie van het juiste Encoding object en roept u GetBytes(String, Int32, Int32, Byte[], Int32) de bijbehorende methode aan. Enkele van de standaardcoderingen die beschikbaar zijn in .NET zijn:

Zie Character Encoding in .NET voor meer informatie.

Zie ook

• Array
• Char
• Int32

Bron:

String.cs

Bron:

String.cs

Bron:

String.cs

Bron:

String.cs

Bron:

String.cs

public:
 cli::array <char> ^ ToCharArray();

public char[] ToCharArray();

member this.ToCharArray : unit -> char[]

Public Function ToCharArray () As Char()

Retouren

Een Unicode-tekenmatrix waarvan de elementen de afzonderlijke tekens van dit exemplaar zijn. Als dit exemplaar een lege tekenreeks is, is de geretourneerde matrix leeg en heeft deze een lengte van nul.

Voorbeelden

In het volgende voorbeeld wordt de ToCharArray methode aangeroepen om de tekens in een tekenreeks te extraheren naar een tekenmatrix. Vervolgens worden de oorspronkelijke tekenreeks en de elementen in de matrix weergegeven.

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

Opmerkingen

Met deze methode wordt elk teken (dat wil gezegd, elk Char object) in een tekenreeks gekopieerd naar een tekenmatrix. Het eerste teken dat is gekopieerd, bevindt zich op index nul van de geretourneerde tekenmatrix; het laatste gekopieerde teken bevindt zich in de index Array.Length - 1.

Als u een tekenreeks wilt maken op basis van de tekens in een tekenmatrix, roept u de String(Char[]) constructor aan.

Als u een bytematrix wilt maken die de gecodeerde tekens in een tekenreeks bevat, maakt u een instantie van het juiste Encoding object en roept u de bijbehorende methode aan Encoding.GetBytes(String) . Enkele van de standaardcoderingen die beschikbaar zijn in .NET zijn onder andere:

Zie Character Encoding in .NET voor meer informatie.

Zie ook

• Char
• Array