External Interfaces Reference

mxAssertS

Check assertion value without printing assertion text

C Syntax

• #include "matrix.h"
  void mxAssertS(int expr, char *error_message);
  

Arguments

expr
   Value of assertion.

error_message
   Description of why assertion failed.

Description

Similar to mxAssert, except mxAssertS does not print the text of the failed assertion. mxAssertS checks the value of an assertion, and continues execution only if the assertion holds. If expr evaluates to logical 1 (true), mxAssertS does nothing. If expr evaluates to logical 0 (false), mxAssertS prints an error to the MATLAB command window consisting of the filename and line number where the assertion failed and the error_message string. The error_message string allows you to specify a better description of why the assertion failed. Use an empty string if you don't want a description to follow the failed assertion message.

After a failed assertion, control returns to the MATLAB command line.

Note that the mex script turns off these assertions when building optimized MEX-functions, so you should use this for debugging purposes only. Build the mex file using the syntax, mex -g filename, in order to use mxAssert.

mxAssert

mxCalcSingleSubscript

© 1994-2005 The MathWorks, Inc.