nearest

kyosu::nearest = {}

inlineconstexpr

Computes the nearest value.

Defined in Header

#include <kyosu/functions.hpp>

Callable Signatures

namespace kyosu
{
   template<kyosu::concepts::cayley_dickson T> constexpr T nearest(T z) noexcept;
   template<eve::floating_ordered_value T>     constexpr T nearest(T z) noexcept;
}

Parameters

• z: Value to for which nearest is computed.

Return value

Returns the nearest of its argument. i.e. the value with parts are the rounding to even of the original ones.

Example

#include <kyosu/kyosu.hpp>
#include <eve/wide.hpp>
#include <iostream>
 
int main()
{
  using kyosu::nearest;
  using kyosu::complex_t;
  using kyosu::quaternion_t;
 
  std::cout << "Real:        ";
  std::cout << 72.9f << " -> " << nearest(72.9f) << "\n";
 
  std::cout << "Complex:     ";
  std::cout << kyosu::complex_t<float>(3.5f,-2.9f) << " -> " << nearest(kyosu::complex_t<float>(3.5f,-2.9f)) << "\n";
 
  std::cout << "Quaternion:  ";
  std::cout << kyosu::quaternion_t<double>(1.,2.,3.,4.) << " -> " << nearest(kyosu::quaternion_t<double>(1.,2.,3.,4.)) << "\n";
 
  std::cout << "SIMD:        ";
  using wc_t = eve::wide<kyosu::complex_t<double>, eve::fixed<2>>;
  std::cout << wc_t(kyosu::complex_t<double>(1.3,-3.7)) << " -> " << nearest(wc_t(kyosu::complex_t<double>(1.3,-3.7))) << "\n";
 
  return 0;
}