convert

auto eve::convert = functor<convert_t>

inlineconstexpr

Defined in Header

#include <eve/module/core.hpp>

Callable Signatures

namespace eve
{
   // Regular overloads
   template<value T, scalar_value Target> Target convert( T x, as_<Target> t)  noexcept; //1
 
   // Semantic option
   constexpr auto convert[saturated](/* any of the above overloads */)         noexcept; // 2
}

Parameters

• x: value to convert.
• t: Type wrapper instance embedding the type to convert x to.

Return value

1. Elementwise conversion of x in the Target type is returned.
2. The expression convert[saturated](x,t) computes a saturated conversion of x to the type wrapped by t

Note

In scalar mode Conversions operated by convert, follow the regular rules of C++ type conversion, including the cases leading to Undefined Behaviors.

Example

// revision 0
#include <eve/module/core.hpp>
#include <iostream>
 
int main()
{
  eve::wide wf0{0.0, 1.0, 2.0, 3.4, -1.0, -2.0, -3.0, -4.1};
  eve::wide wu0{0u, 1u, 2u, 3u, 4u, 5u, 6u, 700u};
 
  std::cout << "<- wf0                      = " << wf0 << "\n";
  std::cout << "<- wu0                      = " << wu0 << "\n";
 
  std::cout << "-> convert(wf0, as<int>())              = " << eve::convert(wf0, eve::as<int>()) << "\n";
  std::cout << "-> convert(wu0, as<signed char>())             = " << eve::convert(wu0, eve::as<signed char>()) << "\n";
  std::cout << "-> convert[saturated](wu0, as<signed char>())  = " << eve::convert[eve::saturated](wu0, eve::as<signed char>()) << "\n";
}