可変数の引数をもつ関数の統合

この例では、1 つだけではなく可変数の引数を受け取る MATLAB^® 関数を使用して .NET アプリケーションを作成する方法について説明します。

この例では、以下の手順を実行します。

MATLAB Compiler SDK™ 製品を使用して、MATLAB 関数 drawgraph を .NET クラス (Plotter) のメソッドに変換し、.NET アセンブリ (VarArgComp) でそのクラスをラップします。関数 drawgraph は入力パラメーターのプロットを表示し、Plotter クラスのメソッドとして呼び出されます。
Plotter クラスをインスタンス化し、MWArray を使用してデータを表すことで、C# アプリケーション (VarArgApp.cs) または Visual Basic^® アプリケーション (VarArgApp.vb) でコンポーネントにアクセスします。
Visual Studio^® .NET 開発環境を使用して VarArgDemoApp アプリケーションをビルドして実行します。

ファイル

MATLAB 関数	`drawgraph.m` `extractcoords.m`
MATLAB 関数の場所	`matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample\VarArgComp\`
C# コードの場所	`matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample\VarArgCSApp\VarArgApp.cs`
Visual Basic コードの場所	`matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample\VarArgVBApp\VarArgApp.vb`

手順

MATLAB 製品に付属している以下のフォルダーを作業フォルダーにコピーします。
```
matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample
```
MATLAB コマンドプロンプトで、作業フォルダー内の新しい VarArgExample\VarArgComp サブフォルダーに移動します。

関数 drawgraph および extractcoords を確認します。

function [xyCoords] = DrawGraph(colorSpec, varargin)

    numVarArgIn= length(varargin);
    xyCoords= zeros(numVarArgIn, 2);

    for idx = 1:numVarArgIn
        xCoord = varargin{idx}(1);
        yCoord = varargin{idx}(2);
        
        x(idx) = xCoord;
        y(idx) = yCoord;
        
        xyCoords(idx,1) = xCoord;
        xyCoords(idx,2) = yCoord;
    end
    
    xmin = min(0, min(x));
    ymin = min(0, min(y));

    axis([xmin fix(max(x))+3 ymin fix(max(y))+3])
    
    plot(x, y, 'color', colorSpec);

function [varargout] = ExtractCoords(coords)

    for idx = 1:nargout
        varargout{idx}= coords(idx,:);
    end

次の情報を使用して、.NET アセンブリコンパイラアプリまたは compiler.build.dotNETAssembly で .NET コンポーネントをビルドします。

フィールド値
ライブラリ名 VarArgComp
クラス名 Plotter
コンパイル対象ファイル extractcoords.m drawgraph.m

たとえば、compiler.build.dotNETAssembly を使用している場合は、以下を入力します。
```
buildResults = compiler.build.dotNETAssembly(["extractcoords.m","drawgraph.m"], ...
'AssemblyName','VarArgComp', ...
'ClassName','Plotter');
```
詳細については、.NET アセンブリの生成と .NET アプリケーションのビルドの手順を参照してください。

フィールド	値
ライブラリ名	`VarArgComp`
クラス名	`Plotter`
コンパイル対象ファイル	`extractcoords.m` `drawgraph.m`

コンポーネントにアクセスするために C# または Visual Basic のどちらを使用するのかを決定します。

C# を使用する場合は、コンポーネントにアクセスする C# アプリケーションのソースコードを作成します。

この例のサンプルアプリケーションは VarArgExample\VarArgCSApp\VarArgApp.cs にあります。

VarArgApp.cs

using System;

using MathWorks.MATLAB.NET.Utility;
using MathWorks.MATLAB.NET.Arrays;

using VarArgComp;


namespace MathWorks.Examples.VarArgApp
 {
  /// <summary>
  /// This application demonstrates how to call components 
  ///  having methods with varargin/vargout arguments.
  /// </summary>
  class VarArgApp
    {
      #region MAIN

      /// <summary>
      /// The main entry point for the application.
      /// </summary>
      [STAThread]
      static void Main(string[] args)
        {
          // Initialize the input data
          MWNumericArray colorSpec= new double[]
                                        {0.9, 0.0, 0.0};
          MWNumericArray data= 
                  new MWNumericArray(new int[,]{{1,2},{2,4},
                                       {3,6},{4,8},{5,10}});  
          MWArray[] coords= null;

          try
            {
              // Create a new plotter object
              Plotter plotter= new Plotter();

              //Extract a variable number of two element x and y coordinate 
              //  vectors from the data array
              coords= plotter.extractcoords(5, data);

              // Draw a graph using the specified color to connect the 
              //   variable number of input coordinates.
              // Return a two column data array containing the input coordinates.
              data= (MWNumericArray)plotter.drawgraph(colorSpec, 
                coords[0], coords[1], coords[2],coords[3], coords[4]);

              Console.WriteLine("result=\n{0}", data);

              Console.ReadLine();  // Wait for user to exit application

              // Note: You can also pass in the coordinate array directly.
              data= (MWNumericArray)plotter.drawgraph(colorSpec, coords);

              Console.WriteLine("result=\n{0}", data); 
 
              Console.ReadLine();  // Wait for user to exit application
            }

          catch(Exception exception)
            {
              Console.WriteLine("Error: {0}", exception);
            }
        }

      #endregion
    }
  }

以下のステートメントは、drawgraph メソッドを呼び出す代替方法です。

data= (MWNumericArray)plotter.drawgraph(colorSpec, 
                coords[0], coords[1], coords[2],coords[3], coords[4]);
...
data= (MWNumericArray)plotter.drawgraph((MWArray)colorSpec, coords);

Visual Basic

Visual Basic を使用する場合は、コンポーネントにアクセスする Visual Basic アプリケーションのソースコードを作成します。

この例のサンプルアプリケーションは VarArgExample\VarArgVBApp\VarArgApp.vb にあります。

VarArgApp.vb

Imports System

Imports MathWorks.MATLAB.NET.Utility
Imports MathWorks.MATLAB.NET.Arrays

Imports VarArgComp


Namespace MathWorks.Demo.VarArgDemoApp


' <summary>
' This application demonstrates how to call components having methods with 
'   varargin/vargout arguments.
' </summary>
Class VarArgDemoApp
    
#Region " MAIN "

        ' <summary>
        ' The main entry point for the application.
        ' </summary>
        Shared Sub Main(ByVal args() As String)

            ' Initialize the input data
            Dim colorSpec As MWNumericArray = 
              New MWNumericArray(New Double() {0.9, 0.0, 0.0})
            Dim data As MWNumericArray = 
              New MWNumericArray(New Integer(,) {{1, 2}, {2, 4}, {3, 6}, {4, 8}, {5, 10}})
            Dim coords() As MWArray = Nothing

            Try

                ' Create a new plotter object
                Dim plotter As Plotter = New Plotter

                'Extract a variable number of two element x and y coordinate 
                ' vectors from the data array
                coords = plotter.extractcoords(5, data)

                ' Draw a graph using the specified color to connect the variable number of 
                '  input coordinates.
                ' Return a two column data array containing the input coordinates.
                data = CType(plotter.drawgraph(colorSpec, coords(0), coords(1), coords(2), 
                   coords(3), coords(4)), _
                             MWNumericArray)

                Console.WriteLine("result={0}{1}", Chr(10), data)

                Console.ReadLine()  ' Wait for user to exit application

                ' Note: You can also pass in the coordinate array directly.
                data = CType(plotter.drawgraph(colorSpec, coords), MWNumericArray)

                Console.WriteLine("result=\{0}{1}", Chr(10), data)

                Console.ReadLine()  ' Wait for user to exit application


            Catch exception As Exception
                Console.WriteLine("Error: {0}", exception)
            End Try
        End Sub
#End Region

    End Class
End Namespace

以下のステートメントは、drawgraph メソッドを呼び出す代替方法です。

data = CType(plotter.drawgraph(colorSpec, coords(0), coords(1), coords(2), 
       coords(3), coords(4)), MWNumericArray)
...
data = CType(plotter.drawgraph(colorSpec, coords), MWNumericArray)

いずれの場合も、VarArgApp プログラムにより次が実行されます。

MWArray クラスライブラリを使用して 3 つの配列 (colorSpec、data、および coords) を初期化する
Plotter オブジェクトを作成する
extracoords メソッドおよび drawgraph メソッドを呼び出す
MWNumericArray を使用して、メソッドで必要なデータを表す
try-catch ブロックを使用して例外をキャッチして処理する

Visual Studio を使用して、ご使用のアプリケーション言語に対応した .NET プロジェクトファイルを開きます。
- C#
  C# を使用する場合は、VarArgCSApp フォルダーにこの例の Visual Studio .NET プロジェクトファイルが含まれています。Windows^® エクスプローラーで VarArgCSApp.csproj をダブルクリックして、Visual Studio .NET でプロジェクトを開きます。[VarArgCSApp.csproj] を右クリックし、[MATLAB の外部で開く] を選択して、デスクトップから開くこともできます。
- Visual Basic
  Visual Basic を使用する場合は、VarArgVBApp フォルダーにこの例の Visual Studio .NET プロジェクトファイルが含まれています。Windows エクスプローラーで VarArgVBApp.vbproj をダブルクリックして、Visual Studio .NET でプロジェクトを開きます。[VarArgVBApp.vbproj] を右クリックし、[MATLAB の外部で開く] を選択して、デスクトップから開くこともできます。
アセンブリを生成またはインストールしたフォルダーにあるアセンブリファイル VarArgComp.dll への参照を作成します。

MWArray API への参照を作成します。

MATLAB がシステムにインストールされている場合	`matlabroot\toolbox\dotnetbuilder\bin\win64\<framework_version>\MWArray.dll`
MATLAB Runtime がシステムにインストールされている場合	`<MATLAB_RUNTIME_INSTALL_DIR>\toolbox\dotnetbuilder\bin\win64\<framework_version>\MWArray.dll`

Visual Studio .NET で VarArgApp アプリケーションをビルドして実行します。
プログラムにより、次の出力が表示されます。
```
result=
     1     2
     2     4
     3     6
     4     8
     5    10
```

参考

compiler.build.dotNETAssembly

可変数の引数をもつ関数の統合

ファイル

手順

参考

トピック