String.ToCharArray String.ToCharArray String.ToCharArray String.ToCharArray Method

정의

이 인스턴스의 문자를 유니코드 문자 배열에 복사합니다.Copies the characters in this instance to a Unicode character array.

오버로드

ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32)

이 인스턴스의 지정된 부분 문자열에 있는 문자를 유니코드 문자 배열에 복사합니다.Copies the characters in a specified substring in this instance to a Unicode character array.

ToCharArray() ToCharArray() ToCharArray() ToCharArray()

이 인스턴스의 문자를 유니코드 문자 배열에 복사합니다.Copies the characters in this instance to a Unicode character array.

ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32) ToCharArray(Int32, Int32)

이 인스턴스의 지정된 부분 문자열에 있는 문자를 유니코드 문자 배열에 복사합니다.Copies the characters in a specified substring in this instance to a Unicode character array.

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 Int32 Int32 Int32

이 인스턴스에 있는 부분 문자열의 시작 위치입니다.The starting position of a substring in this instance.

length
Int32 Int32 Int32 Int32

이 인스턴스에 있는 부분 문자열의 길이입니다.The length of the substring in this instance.

반환

Char[]

해당 요소가 이 인스턴스의 length 문자 위치부터 startIndex 개의 문자로 이루어진 유니코드 문자 배열을 반환합니다.A Unicode character array whose elements are the length number of characters in this instance starting from character position startIndex.

예외

startIndex 또는 length가 0보다 작습니다.startIndex or length is less than zero.

또는-or- startIndex + length가 이 인스턴스의 길이보다 큽니다.startIndex plus length is greater than the length of this instance.

예제

다음 예제에서는 문자열 내에서 부분 문자열을 문자 배열로 변환을 열거 하 고 배열의 요소를 표시 합니다.The following example converts a substring within a string to an array of characters, then enumerates and displays the elements of the array.

// 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)
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
'

설명

이 메서드는 부분 문자열에서에서 문자 배열에 문자를 복사합니다.This method copies the characters in a portion of a string to a character array. 문자열에서 문자 배열의 문자 범위를 만들려면 호출을 String(Char[], Int32, Int32) 생성자입니다.To create a string from a range of characters in a character array, call the String(Char[], Int32, Int32) constructor.

startIndex 매개 변수는 0부터 시작 합니다.The startIndex parameter is zero-based. 즉, 문자열 인스턴스의 첫 번째 문자의 인덱스는 0입니다.That is, the index of the first character in the string instance is zero.

경우 length 가 0 이면 반환 된 배열은 비어 있고 길이가 0입니다.If length is zero, the returned array is empty and has a zero length. 이 인스턴스가 null 또는 빈 문자열 (""), 반환 된 배열은 비어 있고 길이가 0입니다.If this instance is null or an empty string (""), the returned array is empty and has a zero length.

문자열의 부분에 인코딩된 문자를 포함 하는 바이트 배열을 만들려면 적절 한 인스턴스화 Encoding 개체와 호출 해당 GetBytes(String, Int32, Int32, Byte[], Int32) 메서드.To create a byte array that contains the encoded characters in a portion of a string, instantiate the appropriate Encoding object and call its GetBytes(String, Int32, Int32, Byte[], Int32) method. .NET에서 사용할 수 있는 표준 인코딩 중 일부는 다음과 같습니다.Some of the standard encodings available in .NET include:

인코딩Encoding 개체Object
ASCIIASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

자세한 내용은 .NET의 문자 인코딩합니다.For more information, see Character Encoding in .NET.

추가 정보

ToCharArray() ToCharArray() ToCharArray() ToCharArray()

이 인스턴스의 문자를 유니코드 문자 배열에 복사합니다.Copies the characters in this instance to a Unicode character array.

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

반환

Char[]

해당 요소가 이 인스턴스의 각 문자로 이루어진 유니코드 문자 배열을 반환합니다.A Unicode character array whose elements are the individual characters of this instance. 이 인스턴스가 빈 문자열이면 반환된 배열은 길이가 0인 빈 배열입니다.If this instance is an empty string, the returned array is empty and has a zero length.

예제

다음 예제에서는 ToCharArray 문자 배열에 문자열의 문자를 추출 하는 방법입니다.The following example calls the ToCharArray method to extract the characters in a string to a character array. 그런 다음 배열의 원래 문자열 및 요소를 표시합니다.It then displays the original string and the elements in the array.

using System;

public class Example
{
   public static void Main()
   {
      String s = "AaBbCcDd";
      var 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
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

다음 예제에서는 구분 기호로 분리 된 문자열의 구분 기호로 사용 되는 문자를 포함 하는 문자열을 정의 합니다.The following example defines a string containing the characters that serve as delimiters in a delimited string. 그런 다음 호출 하는 ToCharArray 에 전달 될 수 있는 문자 배열을 만드는 방법의 Split(Char[]) 해당 개별 부분 문자열로 구분 된 문자열을 구분 하는 방법.It then calls the ToCharArray method to create a character array that can be passed to the Split(Char[]) method to separate the delimited string into its individual substrings.

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 );
      }

   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
using System;

public class Example
{
   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 (var s in split) {
             Console.WriteLine("-{0}-", s);
         }
      }
   }
}
// The example displays the following output:
//       The delimiters are - ,.:-
//       count =  1 ..............
//       -one two,three:four.-
//       count =  2 ..............
//       -one-
//       -two,three:four.-
//       count =  3 ..............
//       -one-
//       -two-
//       -three:four.-
//       count =  4 ..............
//       -one-
//       -two-
//       -three-
//       -four.-
//       count =  5 ..............
//       -one-
//       -two-
//       -three-
//       -four-
//       --
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 
End Class 
' The example displays the following output:
'       The delimiters are - ,.:-
'       count =  1 ..............
'       -one two,three:four.-
'       count =  2 ..............
'       -one-
'       -two,three:four.-
'       count =  3 ..............
'       -one-
'       -two-
'       -three:four.-
'       count =  4 ..............
'       -one-
'       -two-
'       -three-
'       -four.-
'       count =  5 ..............
'       -one-
'       -two-
'       -three-
'       -four-
'       --

설명

이 메서드는 각 문자를 복사 (즉, 각 Char 개체)에서 문자 배열에는 문자열입니다.This method copies each character (that is, each Char object) in a string to a character array. 복사한 첫 번째 문자가 반환 된 문자 배열의 인덱스 0에 있습니다. 복사한 마지막 문자는 인덱스 Array.Length -1입니다.The first character copied is at index zero of the returned character array; the last character copied is at index Array.Length - 1.

문자 배열의 문자에서 문자열을 만들려면, 호출 된 String(Char[]) 생성자입니다.To create a string from the characters in a character array, call the String(Char[]) constructor.

문자열에 인코딩된 문자를 포함 하는 바이트 배열을 만들려면 적절 한 인스턴스화 Encoding 개체와 호출 해당 Encoding.GetBytes(String) 메서드.To create a byte array that contains the encoded characters in a string, instantiate the appropriate Encoding object and call its Encoding.GetBytes(String) method. .NET에서 사용할 수 있는 표준 인코딩 중 일부는 다음과 같습니다.Some of the standard encodings available in .NET include the following:

인코딩Encoding 개체Object
ASCIIASCII ASCIIEncoding
UTF-7UTF-7 UTF7Encoding
UTF-8UTF-8 UTF8Encoding
UTF-16UTF-16 UnicodeEncoding
UTF-32UTF-32 UTF32Encoding

자세한 내용은 .NET의 문자 인코딩합니다.For more information, see Character Encoding in .NET.

추가 정보

적용 대상