String.ToCharArray 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將此處的字元複製到 Unicode 字元陣列。
多載
| 名稱 | Description |
|---|---|
| ToCharArray(Int32, Int32) |
在此實例中,將指定子串中的字元複製到 Unicode 字元陣列。 |
| ToCharArray() |
將此處的字元複製到 Unicode 字元陣列。 |
ToCharArray(Int32, Int32)
- 來源:
- String.cs
- 來源:
- String.cs
- 來源:
- String.cs
- 來源:
- String.cs
- 來源:
- String.cs
在此實例中,將指定子串中的字元複製到 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()
參數
- startIndex
- Int32
此處為子字串的起始位置。
- length
- Int32
此處為子字串的長度。
傳回
一個 Unicode 字元陣列,其元素是 length 從字元位置 startIndex開始的字元數。
例外狀況
範例
以下範例將字串中的子字串轉換為字元陣列,然後枚舉並顯示陣列的元素。
// 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
'
備註
此方法將字串中的一部分字元複製到字元陣列。 要從字元陣列中的字元範圍建立字串,呼叫建構子。String(Char[], Int32, Int32)
參數 startIndex 是以零為基礎。 也就是說,字串實例中第一個字元的索引為零。
若 length 為零,則回傳陣列為空且長度為零。 若此實例為 null 空字串(“”),則回傳陣列為空且長度為零。
要建立包含字串部分編碼字元的位元組陣列,請實例化相應 Encoding 的物件並呼叫其 GetBytes(String, Int32, Int32, Byte[], Int32) 方法。 .NET 中可用的一些標準編碼包括:
| 編碼 | 物件 |
|---|---|
| ASCII | ASCIIEncoding |
| UTF-7 | UTF7Encoding |
| UTF-8 | UTF8Encoding |
| UTF-16 | UnicodeEncoding |
| UTF-32 | UTF32Encoding |
如需詳細資訊,請參閱 .NET 中的字元編碼。
另請參閱
適用於
ToCharArray()
- 來源:
- String.cs
- 來源:
- String.cs
- 來源:
- String.cs
- 來源:
- String.cs
- 來源:
- String.cs
將此處的字元複製到 Unicode 字元陣列。
public:
cli::array <char> ^ ToCharArray();
public char[] ToCharArray();
member this.ToCharArray : unit -> char[]
Public Function ToCharArray () As Char()
傳回
一個 Unicode 字元陣列,其元素是該實例的個別字元。 若此實例為空字串,則回傳陣列為空且長度為零。
範例
以下範例將提取字串字元的方法呼叫 ToCharArray 到字元陣列。 接著它會顯示原始字串和陣列中的元素。
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
備註
此方法將字串中的每個字元(即每個 Char 物件)複製到字元陣列。 第一個複製的字元位於回傳字元陣列的索引零;最後複製的字元位於索引 Array.Length - 1。
要從字元陣列中的字元建立字串,請呼叫建構子。String(Char[])
要建立包含字串中編碼字元的位元組陣列,請實例化相應 Encoding 的物件並呼叫其 Encoding.GetBytes(String) 方法。 .NET 中可用的標準編碼包括以下幾種:
| 編碼 | 物件 |
|---|---|
| ASCII | ASCIIEncoding |
| UTF-7 | UTF7Encoding |
| UTF-8 | UTF8Encoding |
| UTF-16 | UnicodeEncoding |
| UTF-32 | UTF32Encoding |
如需詳細資訊,請參閱 .NET 中的字元編碼。