영어로 읽기

다음을 통해 공유


String.ToCharArray 메서드

정의

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

오버로드

ToCharArray(Int32, Int32)

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

ToCharArray()

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

ToCharArray(Int32, Int32)

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

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

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

매개 변수

startIndex
Int32

이 인스턴스에 있는 부분 문자열의 시작 위치입니다.

length
Int32

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

반환

Char[]

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

예외

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부터 시작합니다. 즉, 문자열 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의 문자 인코딩을 참조하세요.

추가 정보

적용 대상

.NET 10 및 기타 버전
제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToCharArray()

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

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

C#
public char[] ToCharArray();

반환

Char[]

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

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

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

추가 정보

적용 대상

.NET 10 및 기타 버전
제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0