Quantcast

Documentation Center

  • Trial Software
  • Product Updates

Feval (COM)

Evaluate MATLAB function in Automation server

Synopsis

IDL Method Signature

HRESULT Feval([in] BSTR functionname, [in] long nargout, 
[out] VARIANT* result, [in, optional] VARIANT arg1, arg2, ...)

Microsoft Visual Basic Client

Feval(String functionname, long numout, 
arg1, arg2, ...) As Object

MATLAB Client

result = h.Feval('functionname',numout,arg1,arg2,...)
result = Feval(h,'functionname',numout,arg1,arg2,...)

Description

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

result = Feval(h,'functionname',numout,arg1,arg2,...) is an alternate syntax.

Indicate the number of outputs to be 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.

Passing Mechanism

Description

Pass the value itself

To pass any numeric or string value, specify the value in the Feval argument list:

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

Pass a client variable

To pass an argument assigned to a variable in the client, specify the variable name alone:

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

Reference a server variable

To reference a variable defined in the server, specify the variable name followed by an equals (=) sign:

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

MATLAB does not reassign the server variable.

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")

More About

expand all

Tips

To display the output from Feval in the client window, assign a return value.

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

See Also

| | | |

Was this topic helpful?