다음을 통해 공유


String.ToCharArray 메서드

정의

이 인스턴스의 문자를 유니코드 문자 배열에 복사합니다.

오버로드

ToCharArray(Int32, Int32)

이 인스턴스의 지정된 부분 문자열에 있는 문자를 유니코드 문자 배열에 복사합니다.

ToCharArray()

이 인스턴스의 문자를 유니코드 문자 배열에 복사합니다.

ToCharArray(Int32, Int32)

Source:
String.cs
Source:
String.cs
Source:
String.cs

이 인스턴스의 지정된 부분 문자열에 있는 문자를 유니코드 문자 배열에 복사합니다.

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

이 인스턴스에 있는 부분 문자열의 길이입니다.

반환

Char[]

해당 요소가 이 인스턴스의 length 문자 위치부터 startIndex 개의 문자로 이루어진 유니코드 문자 배열을 반환합니다.

예외

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부터 시작합니다. 즉, 문자열 instance 첫 번째 문자의 인덱스는 0입니다.

가 0이면 length 반환된 배열이 비어 있고 길이가 0입니다. 이 instance null 또는 빈 문자열("")인 경우 반환된 배열은 비어 있고 길이는 0입니다.

문자열의 일부에 인코딩된 문자를 포함하는 바이트 배열을 만들려면 적절한 Encoding 개체를 인스턴스화하고 해당 메서드를 호출합니다 GetBytes(String, Int32, Int32, Byte[], Int32) . .NET에서 사용할 수 있는 표준 인코딩 중 일부는 다음과 같습니다.

Encoding Object
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

자세한 내용은 .NET의 문자 인코딩을 참조하세요.

추가 정보

적용 대상

ToCharArray()

Source:
String.cs
Source:
String.cs
Source:
String.cs

이 인스턴스의 문자를 유니코드 문자 배열에 복사합니다.

public:
 cli::array <char> ^ ToCharArray();
public char[] ToCharArray ();
member this.ToCharArray : unit -> char[]
Public Function ToCharArray () As Char()

반환

Char[]

해당 요소가 이 인스턴스의 각 문자로 이루어진 유니코드 문자 배열을 반환합니다. 이 인스턴스가 빈 문자열이면 반환된 배열은 길이가 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에서 사용할 수 있는 표준 인코딩 중 일부는 다음과 같습니다.

Encoding Object
ASCII ASCIIEncoding
UTF-7 UTF7Encoding
UTF-8 UTF8Encoding
UTF-16 UnicodeEncoding
UTF-32 UTF32Encoding

자세한 내용은 .NET의 문자 인코딩을 참조하세요.

추가 정보

적용 대상