Movatterモバイル変換


[0]ホーム

URL:


cppreference.com
Namespaces
Variants
    Actions

      cospi, cospif, cospil, cospid32, cospid64, cospid128

      From cppreference.com
      <c‎ |numeric‎ |math
       
       
       
      Common mathematical functions
      Functions
      Basic operations
      (C99)
      (C99)
      (C99)
      (C99)(C99)(C99)(C23)
      Maximum/minimum operations
      (C99)
      (C99)
      Exponential functions
      (C23)
      (C99)
      (C99)
      (C23)
      (C23)

      (C99)
      (C99)(C23)
      (C23)
      (C23)
      Power functions
      (C99)
      (C23)
      (C23)

      (C99)
      (C23)
      (C23)
      Trigonometric and hyperbolic functions
      (C23)
      (C23)
      (C23)
      (C23)
      (C99)
      (C99)
      (C99)
      Nearest integer floating-point
      (C99)(C99)(C99)
      (C23)(C23)(C23)(C23)
      Floating-point manipulation
      (C99)(C99)
      (C99)(C23)
      (C99)
      Narrowing operations
      (C23)
      (C23)
      (C23)
      (C23)
      (C23)
      (C23)
      Quantum and quantum exponent
      Decimal re-encoding functions
      Total order and payload functions
      Classification
      Error and gamma functions
      (C99)
      (C99)
      (C99)
      (C99)
      Types
      Macro constants
      Special floating-point values
      (C99)(C23)
      Arguments and return values
      Error handling
      Fast operation indicators
       
      Defined in header<math.h>
      float       cospif(float arg);
      (1)(since C23)
      double      cospi(double arg);
      (2)(since C23)
      longdouble cospil(longdouble arg);
      (3)(since C23)
      _Decimal32  cospid32( _Decimal32 arg);
      (4)(since C23)
      _Decimal64  cospid64( _Decimal64 arg);
      (5)(since C23)
      _Decimal128 cospid128( _Decimal128 arg);
      (6)(since C23)
      Defined in header<tgmath.h>
      #define cospi( arg )
      (7)(since C23)
      1-6) Computes the cosine ofπ·arg measured in radians, thus regardingarg as a measurement in half-revolutions.
      7) Type-generic macro: calls the correct function based on the type ofarg. If the argument has integer type,(2) (cospi) is called.

      The functions(4-6) are declared if and only if the implementation predefines__STDC_IEC_60559_DFP__ (i.e. the implementation supports decimal floating-point numbers).

      (since C23)

      Contents

      [edit]Parameters

      arg - floating-point value whose product withπ represents an angle in radians

      [edit]Return value

      If no errors occur, the cosine ofπ·arg (cos(π×arg)) in the range[-1, +1], is returned.

      [edit]Error handling

      Errors are reported as specified inmath_errhandling.

      If the implementation supports IEEE floating-point arithmetic (IEC 60559):

      • if the argument is ±0, the result is1.0;
      • if the argument is ±∞, NaN is returned andFE_INVALID is raised;
      • if the argument is NaN, NaN is returned.

      [edit]Example

      Run this code
      #include <errno.h>#include <fenv.h>#include <math.h>#include <stdio.h> #ifndef __GNUC__#pragma STDC FENV_ACCESS ON#endif #if __STDC_VERSION__ < 202311L// A naive implementation of a subset of cospi familydouble cospi(double arg){returncos(arg*(double)3.1415926535897932384626433);}#endif int main(void){constdouble pi=acos(-1); // typical usageprintf("cospi(1) = %f, cos(pi) = %f\n", cospi(1),cos(pi));printf("cospi(0.5) = %f, cos(pi/2) = %f\n", cospi(0.5),cos(pi/2));printf("cospi(-0.75) = %f, cos(-3*pi/4) = %f\n", cospi(-0.75),cos(-3* pi/4)); // special valuesprintf("cospi(+0) = %f\n", cospi(0.0));printf("cospi(-0) = %f\n", cospi(-0.0)); // error handlingfeclearexcept(FE_ALL_EXCEPT);printf("cospi(INFINITY) = %f\n", cospi(INFINITY));if(fetestexcept(FE_INVALID))puts("    FE_INVALID raised");}

      Possible output:

      cospi(1) = -1.000000, cos(pi) = -1.000000cospi(0.5) = 0.000000, cos(pi/2) = 0.000000cospi(-0.75) = -0.707107, cos(-3*pi/4) = -0.707107cospi(+0) = 1.000000cospi(-0) = 1.000000cospi(INFINITY) = -nan    FE_INVALID raised

      [edit]References

      • C23 standard (ISO/IEC 9899:2024):
      • 7.12.4.12 The cospi functions (p: 247)
      • 7.27 Type generic math <tgmath.h> (p: 387)

      [edit]See also

      (C99)(C99)
      computes cosine (\({\small\cos{x} }\)cos(x))
      (function)[edit]
      Retrieved from "https://en.cppreference.com/mwiki/index.php?title=c/numeric/math/cospi&oldid=150041"

      [8]ページ先頭

      ©2009-2025 Movatter.jp