mexErrMsgTxt (C and Fortran)
Display error message and return to MATLAB prompt
Note
mexErrMsgTxt
is not recommended. Use mexErrMsgIdAndTxt
instead.
C Syntax
#include "mex.h" void mexErrMsgTxt(const char *errormsg);
Fortran Syntax
subroutine mexErrMsgTxt(errormsg) character*(*) errormsg
Arguments
errormsg
String containing the error message to display
Description
mexErrMsgTxt
writes an error message to the MATLAB® window. After the error message prints, MATLAB terminates the MEX-file and returns control to the MATLAB prompt.
Calling mexErrMsgTxt
does not clear the MEX-file from memory. So,
mexErrMsgTxt
does not invoke the function registered through
mexAtExit
.
If your application called mxCalloc
or one of the
mxCreate
* routines to allocate memory,
mexErrMsgTxt
automatically frees the allocated memory.
Note
If you get warnings when using mexErrMsgTxt
, you might have a
memory management compatibility problem. For more information, see Memory Management Issues.
Remarks
In addition to the errormsg
, the mexerrmsgtxt
function determines where the error occurred, and displays the following information. If
an error labeled Print my error message
occurs in the function
foo
, mexerrmsgtxt
displays:
Error using foo Print my error message