Documentation Center

  • Trial Software
  • Product Updates

mxIsNaN (C and Fortran)

Determine whether input is NaN (Not-a-Number)

C Syntax

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

Fortran Syntax

integer*4 mxIsNaN(value)
real*8 value

Arguments

value

Double-precision, floating-point number you are testing

Returns

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

Description

Call mxIsNaN to determine whether 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® software (and other IEEE-compliant applications) uses to represent an error condition or missing data.

Examples

See the following examples in matlabroot/extern/examples/mx.

See the following examples in matlabroot/extern/examples/refbook.

Was this topic helpful?