MATLAB Application Program Interface Reference

Check assertion value for debugging purposes; doesn't print assertion's text

#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 true, mxAssertS does nothing. If expr is false, mxAssertS prints an error to the MATLAB Command Window consisting of the file name 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.

[ Previous | Help Desk | Next ]