nearest

eve::nearest = functor<nearest_t>

inlineconstexpr

Header file

#include <eve/module/core.hpp>

Callable Signatures

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

• x :value argument.
• c: Conditional expression masking the operation.
• m: Logical value masking the operation.
• ‘tol’ scalar_value tolerance.

Return value

1. the integer nearest to x. If x is an exact half-integer the rounding is made to the nearest even integer.The smallest integer not less than x. The standard proposes 4 rounding modes namely: FE_TONEAREST, FE_DOWNWARD, FE_UPWARD, FE_TOWARDZERO. This function object implements the FE_TONEAREST version.
2. The operation is performed conditionnaly.

External references

• C++ standard reference

Example

// revision 0
#include <eve/module/core.hpp>
#include <iostream>
 
int main()
{
  eve::wide wf0{0.0, 1.0, 2.0, 3.0, -1.0, -2.0, -3.0, -4.0};
  eve::wide wi0{0, 1, 2, 3, -1, -2, -3, -4};
  eve::wide wu0{0u, 1u, 2u, 3u, 4u, 5u, 6u, 7u};
 
  std::cout << "<- wf0                          = " << wf0 << "\n";
  std::cout << "<- wi0                          = " << wi0 << "\n";
  std::cout << "<- wu0                          = " << wu0 << "\n";
                                                
  std::cout << "-> nearest(wf0)                 = " << eve::nearest(wf0) << "\n";
  std::cout << "-> nearest[ignore_last(2)](wf0) = " << eve::nearest[eve::ignore_last(2)](wf0) << "\n";
  std::cout << "-> nearest[wf0 != 0](wf0)       = " << eve::nearest[wf0 != 0](wf0) << "\n";
  std::cout << "-> nearest(wu0)                 = " << eve::nearest(wu0) << "\n";
  std::cout << "-> nearest[ignore_last(2)](wu0) = " << eve::nearest[eve::ignore_last(2)](wu0) << "\n";
  std::cout << "-> nearest[wu0 != 0](wu0)       = " << eve::nearest[wu0 != 0](wu0) << "\n";
  std::cout << "-> nearest(wi0)                 = " << eve::nearest(wi0) << "\n";
  std::cout << "-> nearest[ignore_last(2)](wi0) = " << eve::nearest[eve::ignore_last(2)](wi0) << "\n";
  std::cout << "-> nearest[wi0 != 0](wi0)       = " << eve::nearest[wi0 != 0](wi0) << "\n";
}