Array::ConvertAll<TInput, TOutput> Method (array<TInput>^, Converter<TInput, TOutput>^)
Converts an array of one type to an array of another type.
Assembly: mscorlib (in mscorlib.dll)
public: generic<typename TInput, typename TOutput> static array<TOutput>^ ConvertAll( array<TInput>^ array, Converter<TInput, TOutput>^ converter )
Parameters
- array
-
Type:
array<TInput>^
The one-dimensional, zero-based Array to convert to a target type.
- converter
-
Type:
System::Converter<TInput, TOutput>^
A Converter<TInput, TOutput> that converts each element from one type to another type.
Return Value
Type: array<TOutput>^An array of the target type containing the converted elements from the source array.
Type Parameters
- TInput
The type of the elements of the source array.
- TOutput
The type of the elements of the target array.
| Exception | Condition |
|---|---|
| ArgumentNullException | array is null. -or- converter is null. |
The Converter<TInput, TOutput> is a delegate to a method that converts an object to the target type. The elements of array are individually passed to the Converter<TInput, TOutput>, and the converted elements are saved in the new array.
The source array remains unchanged.
This method is an O(n) operation, where n is the Length of array.
The following code example defines a method named PointFToPoint that converts a PointF structure to a Point structure. The example then creates an array of PointF structures, creates a Converter<PointF, Point> delegate (Converter(Of PointF, Point) in Visual Basic) to represent the PointFToPoint method, and passes the delegate to the ConvertAll<TInput, TOutput> method. The ConvertAll<TInput, TOutput> method passes each element of the input list to the PointFToPoint method and puts the converted elements into a new list of Point structures. Both lists are displayed.
#using <System.Drawing.dll> using namespace System; using namespace System::Drawing; using namespace System::Collections::Generic; Point PointFToPoint(PointF pf) { return Point((int) pf.X, (int) pf.Y); }; void main() { // Create an array of PointF objects. array<PointF>^ apf = { PointF(27.8F, 32.62F), PointF(99.3F, 147.273F), PointF(7.5F, 1412.2F) }; // Display each element in the PointF array. Console::WriteLine(); for each(PointF p in apf) { Console::WriteLine(p); } // Convert each PointF element to a Point object. array<Point>^ ap = Array::ConvertAll(apf, gcnew Converter<PointF, Point>(PointFToPoint) ); // Display each element in the Point array. Console::WriteLine(); for each(Point p in ap) { Console::WriteLine(p); } } /* This code example produces the following output: {X=27.8, Y=32.62} {X=99.3, Y=147.273} {X=7.5, Y=1412.2} {X=27,Y=32} {X=99,Y=147} {X=7,Y=1412} */
Available since 2.0