mexEvalStringWithTrap (C and Fortran)

Execute MATLAB command in caller workspace and capture error information

C Syntax

#include "mex.h"
mxArray *mexEvalStringWithTrap(const char *command);

Fortran Syntax

#include "fintrf.h"
mwPointer mexEvalStringWithTrap(command)
character*(*) command

Description

The mexEvalStringWithTrap function performs the same function as mexEvalString. However, if MATLAB^® detects an error when executing command, MATLAB returns control to the line in the MEX file immediately following the call to mexEvalStringWithTrap.

Input Arguments

command — MATLAB command name

const char* | character*(*)

Name of the MATLAB command to execute, specified as const char* in C or character*(*) in Fortran. In C, the function supports UTF-8 characters.

Output Arguments

ME — Exception

mxArray* | mwPointer | NULL

NULL if no error occurred. Otherwise, returns a pointer specified as mxArray* in C or mwPointer in Fortran of class MException. For information about MException, see Respond to an Exception.

Version History

Introduced before R2006a

R2020b: UTF-8 support added

The mexEvalStringWithTrap function accepts UTF-8 encoded data in addition to supporting LCP encoded strings for backward compatibility.