String.ToCharArray Metod

Definition

Kopierar tecknen i den här instansen till en Unicode-teckenmatris.

Överlagringar

Name Description
ToCharArray(Int32, Int32)

Kopierar tecknen i en angiven delsträng i den här instansen till en Unicode-teckenmatris.

ToCharArray()

Kopierar tecknen i den här instansen till en Unicode-teckenmatris.

ToCharArray(Int32, Int32)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Kopierar tecknen i en angiven delsträng i den här instansen till en Unicode-teckenmatris.

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

Parametrar

startIndex
Int32

Startpositionen för en delsträng i den här instansen.

length
Int32

Längden på delsträngen i den här instansen.

Returer

Char[]

En Unicode-teckenmatris vars element är antalet tecken i den här instansen length med början från teckenpositionen startIndex.

Undantag

startIndex eller length är mindre än noll.

-eller-

startIndex plus length är större än längden på den här instansen.

Exempel

I följande exempel konverteras en delsträng i en sträng till en matris med tecken och räknar sedan upp och visar elementen i matrisen.

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

Kommentarer

Den här metoden kopierar tecknen i en del av en sträng till en teckenmatris. Om du vill skapa en sträng från ett teckenintervall i en teckenmatris anropar String(Char[], Int32, Int32) du konstruktorn.

Parametern startIndex är nollbaserad. Indexet för det första tecknet i stränginstansen är alltså noll.

Om length är noll är den returnerade matrisen tom och har en längd på noll. Om den här instansen är null eller en tom sträng (") är den returnerade matrisen tom och har en längd på noll.

Om du vill skapa en bytematris som innehåller kodade tecken i en del av en sträng instansierar du lämpligt Encoding objekt och anropar dess GetBytes(String, Int32, Int32, Byte[], Int32) metod. Några av de standardkodningar som är tillgängliga i .NET är:

Kodning Objekt
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Mer information finns i Teckenkodning i .NET.

Se även

Gäller för

ToCharArray()

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Kopierar tecknen i den här instansen till en Unicode-teckenmatris.

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

Returer

Char[]

En Unicode-teckenmatris vars element är de enskilda tecknen i den här instansen. Om den här instansen är en tom sträng är den returnerade matrisen tom och har en längd på noll.

Exempel

I följande exempel anropas ToCharArray metoden för att extrahera tecknen i en sträng till en teckenmatris. Den visar sedan den ursprungliga strängen och elementen i matrisen.

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

Kommentarer

Den här metoden kopierar varje tecken (dvs. varje Char objekt) i en sträng till en teckenmatris. Det första tecknet som kopieras är vid index noll för den returnerade teckenmatrisen. det sista tecknet som kopieras är vid index Array.Length - 1.

Om du vill skapa en sträng från tecknen i en teckenmatris anropar String(Char[]) du konstruktorn.

Om du vill skapa en bytematris som innehåller kodade tecken i en sträng instansierar du lämpligt Encoding objekt och anropar dess Encoding.GetBytes(String) metod. Några av de standardkodningar som är tillgängliga i .NET inkluderar följande:

Kodning Objekt
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

Mer information finns i Teckenkodning i .NET.

Se även

Gäller för