External Interfaces/API Reference

mexErrMsgIdAndTxt

Issue error message with identifier and return to the MATLAB prompt

Fortran Syntax

• subroutine mexErrMsgIdAndTxt(errorid, errormsg)
  character*(*) errorid, errormsg
  

Arguments

errorid
   Character array containing a MATLAB message identifier. See Message Identifiers in the MATLAB documentation for information on this topic.

errormsg
   Character array containing the error message to be displayed.

Description

Call mexErrMsgIdAndTxt to write an error message and its corresponding identifier to the MATLAB window. After the error message prints, MATLAB terminates the MEX-file and returns control to the MATLAB prompt.

Calling mexErrMsgIdAndTxt does not clear the MEX-file from memory. Consequently, mexErrMsgIdAndTxt 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, mexErrMsgIdAndTxt automatically frees any associated memory allocated by these calls.

See Also

mexErrMsgTxt, mexWarnMsgIdAndTxt, mexWarnMsgTxt

mexCallMATLAB

mexErrMsgTxt