engEvalString (C) - Evaluate expression in string - MATLAB (original) (raw)

Main Content

Evaluate expression in string

C Syntax

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

Description

engEvalString evaluates the expression contained instring for the MATLAB® engine session, ep, previously started byengOpen.

UNIX Operating Systems

On UNIX® systems, engEvalString sends commands to the MATLAB workspace by writing down a pipe connected to the MATLAB_stdin_ process. MATLAB reads back from stdout any output resulting from the command that ordinarily appears on the screen, into the buffer defined byengOutputBuffer.

To turn off output buffering in C, use:

engOutputBuffer(ep, NULL, 0);

Microsoft Windows Operating Systems

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

Input Arguments

expand all

Pointer to engine, specified as Engine *.

Expression to evaluate, specified as const char *.

Output Arguments

expand all

Status, returned as int. The function returns 1 if the engine session is no longer running or the engine pointer is invalid orNULL. Otherwise, returns 0 even if the MATLAB engine session cannot evaluate the command.

Examples

To open an example, type:

edit([fullfile(matlabroot,"extern","examples","engmat","filename")]);

where filename is:

• engdemo.c for a C example on UNIX operating systems.
• engwindemo.c for a C example on Microsoft® Windows operating systems.

Version History

Introduced before R2006a