asecpi

auto eve::asecpi = functor<asecpi_t>

inlineconstexpr

Header file

#include <eve/module/math.hpp>

Callable Signatures

namespace eve
{
   // Regular overloads
   constexpr auto asecpi(floating_value auto x)                          noexcept; // 1
 
   // Semantic option
   constexpr auto asecpi[raw](floating_value auto x)                     noexcept; // 2
 
   // Lanes masking
   constexpr auto asecpi[conditional_expr auto c](floating_value auto x) noexcept; // 3
   constexpr auto asecpi[logical_value auto m](floating_value auto x)    noexcept; // 3
}

Parameters

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

Return value

1. Returns the elementwise arc secant of the input in \(\pi\) multiples in the range \([0, 1]\). In particular:
   • If the element is \(1\), \(+0\) is returned.
   • If the element is \(0\), \(1\) is returned.
   • If the element \(|x| < 1\), NaN is returned.
   • If the element is a Nan, NaN is returned.
2. Same as 1 but uses a faster implementation which can be slightly less accurate near 'x = 1'
3. The operation is performed conditionnaly.

External references

• Wolfram MathWorld: Inverse Hyperbolic Secant
• Wikipedia: Inverse hyperbolic functions
• DLMF: Inverse hyperbolic functions

Example

// revision 1
#include <eve/module/math.hpp>
#include <iostream>
#include <iomanip>
 
int main()
{
  eve::wide wf = { 5.0f, 2.0f, -1.0f, -2.0f, -5.0f,  1.001f, -1.0f, 0.0f};
 
  std::cout << "<- wf                        = " << wf << "\n";
 
  std::cout << std::setprecision(10);
  std::cout << "-> asecpi(wf)                = " << eve::asecpi(wf) << "\n";
  std::cout << "-> asecpi[raw](wf)           = " << eve::asecpi[eve::raw](wf) << "\n";
  std::cout << "-> asecpi[ignore_last(2)](wf)= " << eve::asecpi[eve::ignore_last(2)](wf) << "\n";
  std::cout << "-> asecpi[wf != -2.0f](wf)   = " << eve::asecpi[wf != -2.0f](wf) << "\n";
}