Learn more about MATLAB

engEvalString (C and Fortran) - Evaluate expression in string

C Syntax

#include "engine.h"
int engEvalString(Engine *ep,const char *string);

Fortran Syntax

integer*4 engEvalString(ep, string)
mwPointer ep
character*(*) string

Arguments

ep

Engine pointer

string

String to execute

Returns

0 if the command was evaluated by the MATLAB engine session, and a nonzero value if unsuccessful. Possible reasons for failure include the engine session is no longer running or the engine pointer is invalid or NULL.

Error Handling

If string detects an error, MATLAB terminates and returns control to the MATLAB prompt.

Description

engEvalString evaluates the expression contained in string for the MATLAB engine session, ep, previously started by engOpen.

UNIX^[1] Operating Systems

On UNIX^® systems, engEvalString sends commands to the MATLAB workspace by writing down a pipe connected to the MATLAB stdin process. Any output resulting from the command that ordinarily appears on the screen is read back from stdout into the buffer defined by engOutputBuffer.

To turn off output buffering in C, use:

engOutputBuffer(ep, NULL, 0);

To turn off output buffering in Fortran, use:

engOutputBuffer(ep, '')

Microsoft Windows Operating Systems

On a Windows system, engEvalString communicates with MATLAB software using a Component Object Model (COM) interface.

C Examples

UNIX Operating Systems

See engdemo.c in the matlabroot/extern/examples/eng_mat folder for sample programs that illustrate how to call the engine functions from a C program.

Windows Operating Systems

See engwindemo.c in the matlabroot/extern/examples/eng_mat folder for sample programs that illustrate how to call the engine functions from a C program for Windows systems.

Fortran Examples

See fengdemo.F in the matlabroot/extern/examples/eng_mat folder for sample programs that illustrate how to call the engine functions from a Fortran program.

See Also

engOpen, engOutputBuffer

---

^[1] UNIX is a registered trademark of The Open Group in the United States and other countries.

engClose (C and Fortran)

engGetVariable (C and Fortran)

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS