String.ToCharArray Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Bu örnekteki karakterleri bir Unicode karakter dizisine kopyalar.

Aşırı Yüklemeler

ToCharArray(Int32, Int32)	Bu örnekte belirtilen bir alt dizedeki karakterleri bir Unicode karakter dizisine kopyalar.
ToCharArray()	Bu örnekteki karakterleri bir Unicode karakter dizisine kopyalar.

ToCharArray(Int32, Int32)

Kaynak:

String.cs

Bu örnekte belirtilen bir alt dizedeki karakterleri bir Unicode karakter dizisine kopyalar.

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

Parametreler

startIndex

Int32

Bu örnekteki bir alt dizenin başlangıç konumu.

length

Int32

Bu örnekteki alt dizenin uzunluğu.

Döndürülenler

Char[]

Öğeleri, karakter konumundan lengthstartIndexbaşlayarak bu örnekteki karakter sayısı olan bir Unicode karakter dizisi.

Özel durumlar

ArgumentOutOfRangeException

startIndex veya length sıfırdan küçüktür.

-veya-

startIndex plus length , bu örneğin uzunluğundan daha büyüktür.

Örnekler

Aşağıdaki örnek, bir dize içindeki alt dizeyi bir karakter dizisine dönüştürür, ardından dizinin öğelerini numaralandırır ve görüntüler.

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

Açıklamalar

Bu yöntem, bir dizenin bir bölümündeki karakterleri bir karakter dizisine kopyalar. Karakter dizisindeki bir karakter aralığından dize oluşturmak için oluşturucuyu çağırın String(Char[], Int32, Int32) .

startIndex parametresi sıfır tabanlıdır. Yani, dize örneğindeki ilk karakterin dizini sıfırdır.

Sıfır ise length , döndürülen dizi boş ve uzunluğu sıfırdır. Bu örnek null veya boş bir dize ("") ise, döndürülen dizi boş ve uzunluğu sıfırdır.

Bir dizenin bir bölümündeki kodlanmış karakterleri içeren bir bayt dizisi oluşturmak için uygun Encoding nesneyi başlatın ve yöntemini çağırın GetBytes(String, Int32, Int32, Byte[], Int32) . .NET'te kullanılabilen standart kodlamalardan bazıları şunlardır:

Encoding	Nesne
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

Daha fazla bilgi için bkz. .NET'te Karakter Kodlama.

Ayrıca bkz.

• Array
• Char
• Int32

ToCharArray()

Kaynak:

String.cs

Bu örnekteki karakterleri bir Unicode karakter dizisine kopyalar.

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

public char[] ToCharArray ();

member this.ToCharArray : unit -> char[]

Public Function ToCharArray () As Char()

Döndürülenler

Char[]

Öğeleri bu örneğin tek tek karakterleri olan bir Unicode karakter dizisi. Bu örnek boş bir dizeyse, döndürülen dizi boş olur ve uzunluğu sıfırdır.

Örnekler

Aşağıdaki örnek, bir dizedeki karakterleri bir karakter dizisine ayıklamak için yöntemini çağırır ToCharArray . Ardından özgün dizeyi ve dizideki öğeleri görüntüler.

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

Açıklamalar

Bu yöntem, bir dizedeki her karakteri (yani her Char nesneyi) bir karakter dizisine kopyalar. Kopyalanan ilk karakter, döndürülen karakter dizisinin sıfır dizinindedir; kopyalanan son karakter dizinde Array.Length - 1'dir.

Karakter dizisindeki karakterlerden bir dize oluşturmak için oluşturucuyu çağırın String(Char[]) .

Bir dizede kodlanmış karakterleri içeren bir bayt dizisi oluşturmak için, uygun Encoding nesnenin örneğini oluşturun ve yöntemini çağırın Encoding.GetBytes(String) . .NET'te kullanılabilen standart kodlamalardan bazıları şunlardır:

Encoding	Nesne
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

Daha fazla bilgi için bkz. .NET'te Karakter Kodlama.

Ayrıca bkz.

• Char
• Array