この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

String.ToCharArray メソッド (Int32, Int32)

 

公開日: 2016年10月

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

名前空間:   System
アセンブリ:  mscorlib (mscorlib.dll 内)

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

パラメーター

startIndex
Type: System.Int32

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

length
Type: System.Int32

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

戻り値

Type: System.Char[]

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

Exception Condition
ArgumentOutOfRangeException

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

または

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

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

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

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

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

エンコード

オブジェクト

ASCII

ASCIIEncoding

UTF-7

UTF7Encoding

UTF-8

UTF8Encoding

UTF-16

UnicodeEncoding

UTF-32

UTF32Encoding

詳細については、「.NET Framework における文字エンコーディング」を参照してください。

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

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

ユニバーサル Windows プラットフォーム
8 以降で使用可能
.NET Framework
1.1 以降で使用可能
ポータブル クラス ライブラリ
サポート対象: 移植可能 .NET プラットフォーム
Windows Phone Silverlight
8.0 以降で使用可能
Windows Phone
8.1 以降で使用可能
トップに戻る
表示: