String.ToCharArray メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

このインスタンスの文字を Unicode 文字配列へコピーします。

オーバーロード

ToCharArray(Int32, Int32)	このインスタンスの指定した部分文字列の文字を Unicode 文字配列へコピーします。
ToCharArray()	このインスタンスの文字を Unicode 文字配列へコピーします。

ToCharArray(Int32, Int32)

ソース:

String.cs

このインスタンスの指定した部分文字列の文字を Unicode 文字配列へコピーします。

C#

public char[] ToCharArray(int startIndex, int length);

パラメーター

startIndex

Int32

このインスタンス内の部分文字列の開始位置。

length

Int32

このインスタンス内の部分文字列の長さ。

戻り値

Char[]

文字位置 startIndex から始まる、このインスタンス内の文字の length 数を要素とする Unicode 文字配列。

例外

ArgumentOutOfRangeException

startIndex または length が 0 未満です。

または

startIndex に length を加算した値がこのインスタンスの長さを超えています。

例

次の例では、文字列内の部分文字列を文字の配列に変換し、配列の要素を列挙して表示します。

C#

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

注釈

このメソッドは、文字列の一部の文字を文字配列にコピーします。 文字配列内の文字範囲から文字列を作成するには、 コンストラクターを String(Char[], Int32, Int32) 呼び出します。

パラメーターは startIndex 0 から始まります。 つまり、文字列インスタンスの最初の文字のインデックスは 0 です。

が 0 の場合 length 、返される配列は空で、長さが 0 です。 このインスタンスが null または空の文字列 ("") の場合、返される配列は空であり、長さが 0 です。

文字列の一部にエンコードされた文字を含むバイト配列を作成するには、適切な Encoding オブジェクトをインスタンス化し、そのメソッドを GetBytes(String, Int32, Int32, Byte[], Int32) 呼び出します。 .NET で使用できる標準エンコードの一部は次のとおりです。

エンコード	Object
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

詳細については、「 .NET での文字エンコード」を参照してください。

こちらもご覧ください

• Array
• Char
• Int32

ToCharArray()

ソース:

String.cs

このインスタンスの文字を Unicode 文字配列へコピーします。

C#

public char[] ToCharArray();

戻り値

Char[]

このインスタンスの各文字を要素とする Unicode 文字配列。 このインスタンスが空の文字列である場合、返される配列は空で、長さは 0 になります。

例

次の例では、 メソッドを ToCharArray 呼び出して、文字列内の文字を文字配列に抽出します。 次に、元の文字列と配列内の要素が表示されます。

C#

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

注釈

このメソッドは、文字列内の各文字 (つまり、各 Char オブジェクト) を文字配列にコピーします。 コピーされた最初の文字は、返される文字配列のインデックス 0 にあります。コピーされた最後の文字はインデックス Array.Length - 1 にあります。

文字配列内の文字から文字列を作成するには、 コンストラクターを String(Char[]) 呼び出します。

文字列にエンコードされた文字を含むバイト配列を作成するには、適切な Encoding オブジェクトをインスタンス化し、そのメソッドを Encoding.GetBytes(String) 呼び出します。 .NET で使用できる標準エンコードには、次のようなものがあります。

エンコード	Object
ASCII	ASCIIEncoding
UTF-7	UTF7Encoding
UTF-8	UTF8Encoding
UTF-16	UnicodeEncoding
UTF-32	UTF32Encoding

詳細については、「 .NET での文字エンコード」を参照してください。

こちらもご覧ください

• Char
• Array