External Interfaces/API Reference

mexErrMsgTxt

Issue error message and return to the MATLAB prompt

Fortran Syntax

• subroutine mexErrMsgTxt(errormsg)
  character*(*) errormsg
  

Arguments

errormsg
   Character array containing the error message to be displayed.

Description

Call mexErrMsgTxt to write 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. Consequently, mexErrMsgTxt does not invoke any registered exit routine to allocate memory.

If your application calls mxCalloc or one of the mxCreate routines to create mxArray pointers, mexErrMsgTxt automatically frees any associated memory allocated by these calls.

See Also

mexErrMsgIdAndTxt, mexWarnMsgTxt, mexWarnMsgIdAndTxt

mexErrMsgIdAndTxt

mexEvalString