Documentation

MATLAB^® allows users to write functions with multiple outputs. To code multiple outputs in C#, use the out keyword.

The following MATLAB code takes multiple inputs (i1, i2, i3) and returns multiple outputs (o1, o2, o3), after performing some checks and calculations.

In this example, the first input and output are of type double, and the second input and output are of type int. The third input and output are of type string.

To deploy this function with MATLAB Production Server™ software, you need to write a corresponding method interface in C#, using the out keyword. Specifying the out keyword causes arguments to be passed by reference. When using out, ensure both the interface method definition and the calling method explicitly specify the out keyword.

The output argument data types listed in your C# interface (referenced with the out keyword) must match the output argument data types listed in your MATLAB signature exactly. Therefore, in the C# interface (MultipleOutputsExample) and method (TryMultipleOutputs) code samples, multiple outputs are listed (with matching specified data types) in the same order as they are listed in your MATLAB function.

 MATLAB Function multipleoutputs

function [o1 o2 o3] = multipleoutputs(i1, i2, i3) 
o1 = modifyinput(i1);
o2 = modifyinput(i2);
o3 = modifyinput(i3);

function out = modifyinput(in)
if( isnumeric(in) )
    out = in*2;
elseif( ischar(in) )
    out = upper(in);
else 
    out = in;
end

 C# Interface MultipleOutputsExample

public interface MultipleOutputsExample
{
    void multipleoutputs(out double o1, out int o2, out string o3, 
                                     double i1, int i2, string i3);
      }

 C# Method TryMultipleOutputs

public static void TryMultipleOutputs()
{
  MWClient client = new MWHttpClient();
  MultipleOutputsExample mpsexample = 
    client.CreateProxy<MultipleOutputsExample>(new Uri("http://localhost:9910/mpsexample"));

  double o1;
  int o2;
  string o3;
  mpsexample.multipleoutputs(out o1, out o2, out o3, 1.2, 10, "hello");
}

After creating a new instance of MWHttpClient and a client proxy, variables and the calling method, multipleoutputs, are declared.

In the multipleoutputs method, values matching each declared types are passed for output (1.2 for double, 10 for int, and hello for string) to output1.

Note the following coding best practices illustrated by this example:

• Both the MATLAB function signature and the C# interface method signature use the name multipleOutputs. Both MATLAB and C# code are processing three inputs and three outputs.

• MATLAB .NET interface supports direct conversion from C# double array to MATLAB double array and from C# string to MATLAB char array. For more information, see Data Conversion with C# and MATLAB Types and Conversion Between MATLAB Types and C# Types.