String.ToCharArray メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このインスタンスの文字を Unicode 文字配列へコピーします。
オーバーロード
ToCharArray(Int32, Int32) |
このインスタンスの指定した部分文字列の文字を Unicode 文字配列へコピーします。 |
ToCharArray() |
このインスタンスの文字を Unicode 文字配列へコピーします。 |
ToCharArray(Int32, Int32)
- ソース:
- 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
このインスタンス内の部分文字列の長さ。
戻り値
文字位置 startIndex
から始まる、このインスタンス内の文字の length
数を要素とする Unicode 文字配列。
例外
startIndex
または length
が 0 未満です。
または
startIndex
に length
を加算した値がこのインスタンスの長さを超えています。
例
次の例では、文字列内の部分文字列を文字の配列に変換し、配列の要素を列挙して表示します。
// 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
'
注釈
このメソッドは、文字列の一部の文字を文字配列にコピーします。 文字配列内の文字範囲から文字列を作成するには、 コンストラクターを 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 での文字エンコード」を参照してください。
こちらもご覧ください
適用対象
ToCharArray()
- ソース:
- 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 文字配列。 このインスタンスが空の文字列である場合、返される配列は空で、長さは 0 になります。
例
次の例では、 メソッドを 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 オブジェクト) を文字配列にコピーします。 コピーされた最初の文字は、返される文字配列のインデックス 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 での文字エンコード」を参照してください。
こちらもご覧ください
適用対象
.NET