String.ToCharArray メソッド ()

.NET Framework クラス ライブラリ リファレンス

String.ToCharArray メソッド ()

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

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

Visual Basic (宣言)

Public Function ToCharArray As
 Char()

Visual Basic (使用法)

Dim instance As String
Dim returnValue As Char()

returnValue = instance.ToCharArray

C#

public char[] ToCharArray ()

C++

public:
array<wchar_t>^ ToCharArray ()

J#

public char[] ToCharArray ()

JScript

public function ToCharArray () : char[]

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

使用例

String から Unicode 文字の配列を簡単に作成する方法を次のコード例に示します。この配列は、次に Split メソッドで使用されます。

Visual Basic

Imports System
Imports Microsoft.VisualBasic
 _

Public Class StringSplit2
   
   Public Shared Sub Main()
      
      Dim delimStr As String
 = " ,.:"
      Dim delimiter As Char()
 = delimStr.ToCharArray()
      Dim words As String
 = "one two,three:four."
      Dim split As String()
 = Nothing
      
      Console.WriteLine("The delimiters are -{0}-",
 delimStr)
      Dim x As Integer
      For x = 1 To 5
         split = words.Split(delimiter, x)
         Console.WriteLine(ControlChars.Cr + "count = {0,2} ..............",
 x)
         Dim s As String
         For Each s In 
 split
            Console.WriteLine("-{0}-", s)
         Next s
      Next x
   End Sub 'Main
End Class 'StringSplit2

C#

using System;

public class StringSplit2 {
    public static void Main()
 {

        string delimStr = " ,.:";
    char [] delimiter = delimStr.ToCharArray();
        string words = "one two,three:four.";
        string [] split = null;

    Console.WriteLine("The delimiters are -{0}-", delimStr);
    for (int x = 1; x <= 5; x++) {
        split = words.Split(delimiter, x);
            Console.WriteLine("\ncount = {0,2} ..............", x);
        foreach (string s in
 split) {
                Console.WriteLine("-{0}-", s);
              }
    }
    }
}

C++

using namespace System;
using namespace System::Collections;
int main()
{
   String^ delimStr = " ,.:";
   array<Char>^delimiter = delimStr->ToCharArray();
   String^ words = "one two,three:four.";
   array<String^>^split = nullptr;
   Console::WriteLine( "The delimiters are -{0}-", delimStr );
   for ( int x = 1; x <= 5; x++ )
   {
      split = words->Split( delimiter, x );
      Console::WriteLine( "\ncount = {0, 2} ..............", x );
      IEnumerator^ myEnum = split->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         String^ s = safe_cast<String^>(myEnum->Current);
         Console::WriteLine( "-{0}-", s );
      }

   }
}

J#

import System.*;

public class StringSplit2
{
    public static void main(String[]
 args)
    {
        String delimStr = " ,.:";
        char delimiter[] = delimStr.ToCharArray();
        String words = "one two,three:four.";
        String split[] = null;

        Console.WriteLine("The delimiters are -{0}-", delimStr);
        for (int x = 1; x <= 5; x++) {
            split = words.Split(delimiter, x);
            Console.WriteLine("\ncount = {0,2} ..............",
                System.Convert.ToString(x));
            for (int iCtr = 0; iCtr < split.get_Length();
 iCtr++) {
                String s = split[iCtr];
                Console.WriteLine("-{0}-", s);
            }
        }
    } //main
} //StringSplit2

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
Char 構造体
Array クラス

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

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

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

Visual Basic (宣言)

Public Function ToCharArray ( _
    startIndex As Integer, _
    length As Integer _
) As Char()

Visual Basic (使用法)

Dim instance As String
Dim startIndex As Integer
Dim length As Integer
Dim returnValue As Char()

returnValue = instance.ToCharArray(startIndex, length)

C#

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

C++

public:
array<wchar_t>^ ToCharArray (
    int startIndex, 
    int length
)

J#

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

JScript

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

パラメータ

startIndex

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

length

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

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

例外

例外の種類	条件
ArgumentOutOfRangeException	startIndex または length が 0 未満です。 または startIndex と length を合計した値が、このインスタンスの長さよりも大きい値です。

解説

length が 0 の場合、startIndex の値は無視され、文字列全体がこのインスタンスの先頭からコピーされます。このインスタンスが空の文字列 ("") である場合、返される配列は空で、長さは 0 になります。

使用例

文字列から部分文字列を取り出して文字の配列に変換し、配列の要素を列挙しながら表示するコード例を次に示します。

Visual Basic

' Sample for String.ToCharArray(Int32, Int32)
Imports System

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 'Main
End Class 'Sample
'
'This example produces the following results:
'The letters in '012wxyz789' are: 'wxyz'
'Each letter in '012wxyz789' is:
'w
'x
'y
'z
'

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

C++

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

J#

// Sample for String.ToCharArray(Int32, Int32)
import System.*;

class Sample
{
    public static void main(String[]
 args)
    {
        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);
        for (int iCtr = 0; iCtr < arr.length;
 iCtr++) {
            char c = arr[iCtr];
            Console.WriteLine(c);
        }
    } //main
} //Sample
/*
This example produces the following results:
The letters in '012wxyz789' are: 'wxyz'
Each letter in '012wxyz789' is:
w
x
y
z
*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
String クラス
String メンバ
System 名前空間
Array クラス
Char 構造体
Int32 構造体

String.ToCharArray メソッド

このインスタンスの文字を Unicode 文字配列へコピーします。
オーバーロードの一覧

名前	説明
String.ToCharArray ()	このインスタンスの文字を Unicode 文字配列へコピーします。 .NET Compact Framework によってサポートされています。
String.ToCharArray (Int32, Int32)	このインスタンスの指定した部分文字列の文字を Unicode 文字配列へコピーします。 .NET Compact Framework によってサポートされています。

参照

関連項目

String クラス
String メンバ
System 名前空間
Char 構造体
Array クラス