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