String.ToCharArray Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Menyalin karakter dalam instans ini ke array karakter Unicode.

Overload

ToCharArray(Int32, Int32)	Menyalin karakter dalam substring tertentu dalam instans ini ke array karakter Unicode.
ToCharArray()	Menyalin karakter dalam instans ini ke array karakter Unicode.

ToCharArray(Int32, Int32)

Sumber:

String.cs

Menyalin karakter dalam substring tertentu dalam instans ini ke array karakter 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()

Parameter

startIndex

Int32

Posisi awal substring dalam instans ini.

length

Int32

Panjang substring dalam instans ini.

Mengembalikan

Char[]

Array karakter Unicode yang elemennya adalah length jumlah karakter dalam instans ini mulai dari posisi startIndexkarakter .

Pengecualian

ArgumentOutOfRangeException

startIndex atau length kurang dari nol.

-atau-

startIndex plus length lebih besar dari panjang instans ini.

Contoh

Contoh berikut mengonversi substring dalam string menjadi array karakter, lalu menghitung dan menampilkan elemen 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)
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
'

Keterangan

Metode ini menyalin karakter dalam sebagian string ke array karakter. Untuk membuat string dari rentang karakter dalam array karakter, panggil String(Char[], Int32, Int32) konstruktor.

Parameternya startIndex berbasis nol. Artinya, indeks karakter pertama dalam instans string adalah nol.

Jika length nol, array yang dikembalikan kosong dan memiliki panjang nol. Jika instans ini adalah null atau string kosong (""), array yang dikembalikan kosong dan memiliki panjang nol.

Untuk membuat array byte yang berisi karakter yang dikodekan dalam sebagian string, buat objek yang sesuai Encoding dan panggil metodenya GetBytes(String, Int32, Int32, Byte[], Int32) . Beberapa pengodean standar yang tersedia di .NET meliputi:

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

Untuk informasi selengkapnya, lihat Pengodean Karakter di .NET.

Lihat juga

• Array
• Char
• Int32

ToCharArray()

Sumber:

String.cs

Menyalin karakter dalam instans ini ke array karakter Unicode.

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

public char[] ToCharArray ();

member this.ToCharArray : unit -> char[]

Public Function ToCharArray () As Char()

Mengembalikan

Char[]

Array karakter Unicode yang elemennya adalah karakter individual dari instans ini. Jika instans ini adalah string kosong, array yang dikembalikan kosong dan memiliki panjang nol.

Contoh

Contoh berikut memanggil ToCharArray metode untuk mengekstrak karakter dalam string ke array karakter. Kemudian menampilkan string asli dan elemen dalam array.

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

Keterangan

Metode ini menyalin setiap karakter (yaitu, setiap Char objek) dalam string ke array karakter. Karakter pertama yang disalin adalah pada indeks nol dari array karakter yang dikembalikan; karakter terakhir yang disalin adalah pada indeks Array.Length - 1.

Untuk membuat string dari karakter dalam array karakter, panggil String(Char[]) konstruktor.

Untuk membuat array byte yang berisi karakter yang dikodekan dalam string, buat objek yang sesuai Encoding dan panggil metodenya Encoding.GetBytes(String) . Beberapa pengodean standar yang tersedia di .NET meliputi yang berikut ini:

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

Untuk informasi selengkapnya, lihat Pengodean Karakter di .NET.

Lihat juga

• Char
• Array