Description

result = Feval(h,'functionname',numout,arg1,arg2,...) executes the MATLAB^® function specified by functionname in the Automation server attached to handle h. The function name is case-sensitive.

COM functions are available on Microsoft^® Windows^® systems only.

Indicate the number of outputs returned by the function in a 1-by-1 double array, numout. The server returns output from the function in the cell array, result.

You can specify as many as 32 input arguments to be passed to the function. These arguments follow numout in the Feval argument list. The following table shows ways to pass an argument.

a = Feval(h,'sin',1,-pi:0.01:pi);

x = -pi:0.01:pi;
a = Feval(h,'sin',1,x);

PutWorkspaceData(h,'x','base',-pi:0.01:pi);
a = Feval(h,'sin',1,'x=');

Visual Basic .NET Examples

Passing Arguments

This example shows how to pass arguments using Feval to execute MATLAB commands on a MATLAB Automation server from a Visual Basic^® .NET client.

• Pass two strings to the MATLAB function strcat on the server:

  Dim Matlab As Object 
  Dim out As Object 
  out = Nothing 
  Matlab = CreateObject("matlab.application") 
  Matlab.Feval("strcat",1,out,"hello"," world") 
  

• Define clistr locally and pass this variable:

  Dim clistr As String
  clistr = " world"
  Matlab.Feval("strcat",1,out,"hello",clistr)

• Pass the name of a variable defined on the server:

  Matlab.PutCharArray("srvstr","base"," world")
  Matlab.Feval("strcat",1,out,"hello","srvstr=")

Defining Feval Return Values

Feval returns data from the evaluated function in a cell array. The cell array has one row for every return value. You control the number of return values using the numout argument.

Dim Matlab As Object
Dim out As Object
Matlab = CreateObject("matlab.application")
Matlab.Feval("fileparts",3,out,"d:\work\ConsoleApp.cpp")

Creating Server Variables

To modify server variable A, define variables rows and cols in the client.

• Create a matrix, A, in the server.

  Dim Matlab As Object
  Dim server_version As String
  Matlab = CreateObject("matlab.application")
  MatLab.PutWorkspaceData("A","base",rand(6))
  

• Reshape A.

  rows = 6
  cols = 3
  Matlab.Feval("reshape",0,"A=",rows,cols)

  MATLAB interprets A in the expression 'A=' as a server variable name.

• The reshape function does not modify variable A.

  Matlab.GetWorkspaceData("A","base",B)

  A is unchanged.

• To get the result of the reshape function, use the numout argument to assign the value to C.

  Matlab.Feval("reshape",1,"A=",rows,cols,C)

See Also

Execute | GetCharArray | GetFullMatrix | PutCharArray | PutFullMatrix