External Interfaces/API Reference

mxIsNaN

True if value is NaN (Not-a-Number)

C Syntax

• #include "matrix.h"
  bool mxIsNaN(double value);
  

Arguments

value
   The double-precision, floating-point number that you are testing.

Returns

true if value is NaN (Not-a-Number), and false otherwise.

Description

Call mxIsNaN to determine whether or not value is NaN. NaN is the IEEE arithmetic representation for Not-a-Number. A NaN is obtained as a result of mathematically undefined operations such as

• 0.0/0.0
• Inf-Inf

The system understands a family of bit patterns as representing NaN. In other words, NaN is not a single value, rather it is a family of numbers that MATLAB (and other IEEE-compliant applications) use to represent an error condition or missing data.

Examples

See mxisfinite.c in the mx subdirectory of the examples directory.

For additional examples, see findnz.c and fulltosparse.c in the refbook subdirectory of the examples directory.

See Also

mxIsFinite, mxIsInf

mxIsLogicalScalarTrue

mxIsNumeric