Movatterモバイル変換


[0]ホーム

URL:


cppreference.com
Namespaces
Variants
    Actions

      std::numeric_limits<T>::signaling_NaN

      From cppreference.com
      <cpp‎ |types‎ |numeric limits
       
       
      Utilities library
       
       
      std::numeric_limits
      Static constants
      Static member functions
      numeric_limits::signaling_NaN
      Helper types
       
      static T signaling_NaN()throw();
      (until C++11)
      staticconstexpr T signaling_NaN()noexcept;
      (since C++11)

      Returns the special value "signalingnot-a-number", as represented by the floating-point typeT. Only meaningful ifstd::numeric_limits<T>::has_signaling_NaN==true. In IEEE 754, the most common binary representation of floating-point numbers, any value with all bits of the exponent set and at least one bit of the fraction set represents a NaN. It is implementation-defined which values of the fraction represent quiet or signaling NaNs, and whether the sign bit is meaningful.

      Contents

      [edit]Return value

      Tstd::numeric_limits<T>::signaling_NaN()
      /* non-specialized */T()
      boolfalse
      char0
      signedchar0
      unsignedchar0
      wchar_t0
      char8_t(since C++20)0
      char16_t(since C++11)0
      char32_t(since C++11)0
      short0
      unsignedshort0
      int0
      unsignedint0
      long0
      unsignedlong0
      longlong(since C++11)0
      unsignedlonglong(since C++11)0
      float implementation-defined (may beFLT_SNAN)
      double implementation-defined (may beDBL_SNAN)
      longdouble implementation-defined (may beLDBL_SNAN)

      [edit]Notes

      A NaN never compares equal to itself. Copying a NaN is not required, by IEEE-754, to preserve its bit representation (sign andpayload), though most implementation do.

      When a signaling NaN is used as an argument to an arithmetic expression, the appropriate floating-point exception may be raised and the NaN is "quieted", that is, the expression returns a quiet NaN.

      [edit]Example

      Demonstrates the use of a signaling NaN to raise a floating-point exception:

      Run this code
      #include <cfenv>#include <iostream>#include <limits> #pragma STDC_FENV_ACCESS on void show_fe_exceptions(){int n=std::fetestexcept(FE_ALL_EXCEPT); if(n&FE_INVALID)std::cout<<"FE_INVALID is raised\n";elseif(n==0)std::cout<<"no exceptions are raised\n"; std::feclearexcept(FE_ALL_EXCEPT);} int main(){double snan=std::numeric_limits<double>::signaling_NaN();std::cout<<"After sNaN was obtained, ";    show_fe_exceptions(); double qnan= snan*2.0;std::cout<<"After sNaN was multiplied by 2, ";    show_fe_exceptions(); double qnan2= qnan*2.0;std::cout<<"After the quieted NaN was multiplied by 2, ";    show_fe_exceptions(); std::cout<<"The result is "<< qnan2<<'\n';}

      Output:

      After sNaN was obtained, no exceptions are raisedAfter sNaN was multiplied by 2, FE_INVALID is raisedAfter the quieted NaN was multiplied by 2, no exceptions are raisedThe result is nan

      [edit]See also

      identifies floating-point types that can represent the special value "signaling not-a-number" (NaN)
      (public static member constant)[edit]
      [static]
      returns a quiet NaN value of the given floating-point type
      (public static member function)[edit]
      (C++11)
      checks if the given number is NaN
      (function)[edit]
      Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/types/numeric_limits/signaling_NaN&oldid=148442"

      [8]ページ先頭

      ©2009-2026 Movatter.jp