This documentation is archived and is not being maintained.
String::ToCharArray Method
Visual Studio 2010
Copies the characters in this instance to a Unicode character array.
Assembly: mscorlib (in mscorlib.dll)
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.
The following example demonstrates how to easily create a Unicode character array from a String. The array is then used with 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- // --
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: