Export (0) Print
Expand All

String::ToCharArray Method

Copies the characters in this instance to a Unicode character array.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public:
array<wchar_t>^ ToCharArray()

Return Value

Type: array<System::Char>
A Unicode character array whose elements are the individual characters of this instance. If this instance is an empty string, the returned array is empty and has a zero length.

This method copies each character (that is, each Char object) in a string to a character array. The first character copied is at index zero of the returned character array; the last character copied is at index Array::Length – 1.

To create a string from the characters in a character array, call the String(array<Char>) constructor.

The following example demonstrates how to easily create a Unicode character array from a String. The array is then supplied as the separator argument to the Split method.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft