Array.ConvertAll ジェネリックメソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Array.ConvertAll ジェネリックメソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ある型の配列を別の型の配列に変換します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function ConvertAll(Of
 TInput, TOutput) ( _
    array As TInput(), _
    converter As Converter(Of TInput, TOutput)
 _
) As TOutput()

Visual Basic (使用法)

Dim array As TInput()
Dim converter As Converter(Of
 TInput, TOutput)
Dim returnValue As TOutput()

returnValue = Array.ConvertAll(array, converter)

public static TOutput[] ConvertAll<TInput,TOutput>
 (
    TInput[] array,
    Converter<TInput,TOutput> converter
)

C++

public:
generic<typename TInput, typename TOutput>
static array<TOutput>^ ConvertAll (
    array<TInput>^ array, 
    Converter<TInput, TOutput>^ converter
)

J# では、ジェネリックな型およびメソッドは使用できますが、新規に宣言することはできません。

JScript

JScript では、ジェネリックな型およびメソッドは使用できません。

型パラメータ

: TInput
元の配列要素の型。

: TOutput
変換後の配列要素の型。

パラメータ

array: 変換元となる、インデックス番号が 0 から始まる 1 次元 Array。

converter: 各要素の型を変換するための Converter。

戻り値
要素の型を変換した後の配列。

例外

例外の種類	条件
ArgumentNullException	array が null 参照 (Visual Basic では Nothing) です。または converter が null 参照 (Visual Basic では Nothing) です。

例外の種類

条件

ArgumentNullException

array が null 参照 (Visual Basic では Nothing) です。

または

converter が null 参照 (Visual Basic では Nothing) です。

解説

Converter は、オブジェクトを別の型に変換するメソッドのデリゲートです。array の要素が、それぞれ Converter に渡され、変換後の要素が新しい配列に格納されます。

元の array は変更されません。

このメソッドは O(n) 操作です。ここで、n は array の Length です。

使用例

PointF 構造体を Point 構造体に変換する PointFToPoint という名前のメソッドを定義するコード例を次に示します。この例では、次に PointF 構造体の配列を作成し、Converter<PointF, Point> デリゲート (Visual Basic では Converter(Of PointF, Point)) を作成して PointFToPoint メソッドを表し、そのデリゲートを ConvertAll メソッドに渡します。ConvertAll メソッドは、入力リストの各要素を PointFToPoint メソッドに渡し、変換された要素を Point 構造体の新しいリストに格納します。両方のリストが表示されます。

Visual Basic

Imports System
Imports System.Drawing
Imports System.Collections.Generic

Public Class Example

    Public Shared Sub Main()

        Dim apf() As PointF = { _
            New PointF(27.8, 32.62), _
            New PointF(99.3, 147.273), _
            New PointF(7.5, 1412.2)  }

        Console.WriteLine()
        For Each p As PointF
 In apf
            Console.WriteLine(p)
        Next

        Dim ap() As Point = Array.ConvertAll(apf,
 _
            New Converter(Of PointF, Point)(AddressOf
 PointFToPoint))

        Console.WriteLine()
        For Each p As Point
 In ap
            Console.WriteLine(p)
        Next

    End Sub

    Public Shared Function
 PointFToPoint(ByVal pf As PointF) _
        As Point

        Return New Point(CInt(pf.X), CInt(pf.Y))
    End Function
End Class

' 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=28,Y=33}
'{X=99,Y=147}
'{X=8,Y=1412}

using System;
using System.Drawing;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        PointF[] apf = {
            new PointF(27.8F, 32.62F),
            new PointF(99.3F, 147.273F),
            new PointF(7.5F, 1412.2F) };

        Console.WriteLine();
        foreach( PointF p in apf )
        {
            Console.WriteLine(p);
        }

        Point[] ap = Array.ConvertAll(apf, 
            new Converter<PointF, Point>(PointFToPoint));

        Console.WriteLine();
        foreach( Point p in ap )
        {
            Console.WriteLine(p);
        }
    }

    public static Point PointFToPoint(PointF
 pf)
    {
        return new Point(((int)
 pf.X), ((int) pf.Y));
    }
}

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