acosh

auto eve::acosh = functor<acosh_t>

inlineconstexpr

Header file

#include <eve/module/math.hpp>

Callable Signatures

namespace eve
{
   // Regular overload
   constexpr auto acosh(floating_value auto x)                         noexcept; // 1
 
   // Lanes masking
   constexpr auto acosh[conditional_expr auto c](floating_value auto x) noexcept; // 2
   constexpr auto acosh[logical_value auto m](floating_value auto x)    noexcept; // 2
}

Parameters

• x: floating value.
• c: Conditional expression masking the operation.
• m: Logical value masking the operation.

Return value

1. Returns the elementwise inverse hyperbolic cosine of the input. For values in the domain x>1, the inverse hyperbolic cosine is semantically equivalent to \(\log(x+\sqrt{x^2-1})\). In particular:
   • If x is less than \(1\) or Nan, NaN is returned.
   • If x is \(1\), \(+0\) is returned.
   • If x is \(+\infty\), \(+\infty\) is returned.
   • If x is a Nan, NaN is returned.
2. The operation is performed conditionnaly.

External references

• C++ standard reference: acosh
• Wolfram MathWorld: Inverse Hyperbolic Cosine
• Wikipedia: Inverse hyperbolic functions
• DLMF

Example

// revision 1
#include <eve/module/math.hpp>
#include <iostream>
 
int main()
{
  eve::wide wf = {1.0f, 2.0f, eve::inf(eve::as<float>()), eve::nan(eve::as<float>())};
 
  std::cout << "<- wf                       = " << wf << "\n";
 
  std::cout << "-> acosh(wf)                = " << eve::acosh(wf) << "\n";
  std::cout << "-> acosh[ignore_last(2)](wf)= " << eve::acosh[eve::ignore_last(2)](wf) << "\n";
  std::cout << "-> acosh[wf != 2.0f](wf)    = " << eve::acosh[wf != 2.0f](wf) << "\n";
}