inc

eve::inc = {}

inlineconstexpr

return the input incremented by one.

Defined in Header

#include <eve/module/core.hpp>

Callable Signatures

namespace eve
{
   template< eve::value T >
   T inc(T x) noexcept;
}

Parameters

• x : real or complex argument.

Return value

The value of x + 1 is returned.

Example

#include <eve/module/core.hpp>
#include <eve/wide.hpp>
#include <iostream>
 
using wide_ft = eve::wide<float, eve::fixed<4>>;
 
int main()
{
  wide_ft pf = {0.0f, 1.0f, -1.0f, -2.0f};
 
  std::cout << "---- simd" << '\n'
            << "<- pf            = " << pf << '\n'
            << "-> eve::inc(pf)  = " << eve::inc(pf) << '\n';
 
  float xf = 1.0f;
 
  std::cout << "---- scalar" << '\n'
            << "<- xf           = " << xf << '\n'
            << "-> eve::inc(xf) = " << eve::inc(xf) << '\n';
 
  return 0;
}

Semantic Modifiers

• Masked Call

  The call eve::inc[mask](x, ...) provides a masked version of inc which is equivalent to if_else(mask, inc(x, ...), x)

  Example

  #include <eve/module/core.hpp>
  #include <eve/wide.hpp>
  #include <iostream>
   
  using wide_ft = eve::wide<float, eve::fixed<4>>;
   
  int main()
  {
    wide_ft pf = {0.0f, 1.0f, -1.0f, 10.0f};
   
    std::cout << "---- simd" << '\n'
              << "<- pf            = " << pf << '\n'
              << "-> eve::inc[pf < 5.0f](pf)  = " << eve::inc[pf < 5.0f](pf) << '\n';
    return 0;
  }

• eve::saturated

  The call saturated(inc)(x) computes the saturated increment of x. The only interest of this behaviour is that for integral type T the call saturated(inc)(Valmax<T>()) returns Valmax<T>().

  Example

  #include <eve/module/core.hpp>
  #include <eve/wide.hpp>
  #include <iostream>
   
  using wide_ft = eve::wide<std::int8_t, eve::fixed<4>>;
   
  int main()
  {
    wide_ft pf = {0, 1, -127, -128};
   
    std::cout << "---- simd" << '\n'
              << "<- pf                 = " << pf << '\n'
              << "-> saturated(inc)(pf) = " << eve::saturated(eve::inc)(pf) << '\n';
    return 0;
  }