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 equal to 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 being equivalent to NaN. In other words, NaN is not a single value, rather it is a family of numbers that MATLAB (and other IEEE-compliant applications) interpret as being equal to Not-a-Number.

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

mxIsLogical

mxIsNumeric