E.V.E
v2023.02.15
 
Loading...
Searching...
No Matches

◆ add

auto eve::add = functor<add_t>
inlineconstexpr

Header file

#include <eve/module/core.hpp>

Callable Signatures

namespace eve
{
// Regular overloads
constexpr auto add(value auto x, value auto ... xs) noexcept; // 1
constexpr auto add(kumi::non_empty_product_type auto const& tup) noexcept; // 2
// Lanes masking
constexpr auto add[conditional_expr auto c](/*any of the above overloads*/) noexcept; // 3
constexpr auto add[logical_value auto m](/*any of the above overloads*/) noexcept; // 3
// Semantic options
constexpr auto add[saturated](/*any of the above overloads*/) noexcept; // 4
constexpr auto add[lower](/*any of the above overloads*/) noexcept; // 5
constexpr auto add[upper](/*any of the above overloads*/) noexcept; // 6
constexpr auto add[lower][strict](/*any of the above overloads*/) noexcept; // 5
constexpr auto add[upper][strict](/*any of the above overloads*/) noexcept; // 6
constexpr auto add[widen](/*any of the above overloads*/) noexcept; // 7
}
Specifies that a type is a Conditional Expression.
Definition conditional.hpp:28
The concept logical_value<T> is satisfied if and only if T satisfies eve::value and the element type ...
Definition value.hpp:132
The concept value<T> is satisfied if and only if T satisfies either eve::scalar_value or eve::simd_va...
Definition value.hpp:34
constexpr auto add
tuple_callable computing the sum of its arguments.
Definition add.hpp:122
EVE Main Namespace.
Definition abi.hpp:18

Parameters

Return value

The value of the sum of the arguments is returned.

  1. Take care that for floating entries, the addition is not perfectly associative due to rounding errors. This call performs additions in reverse incoming order.
  2. equivalent to the call on the elements of the tuple.
  3. The operation is performed conditionnaly
  4. The call add[saturated](...) computes a saturated version of add. Take care that for signed integral entries this kind of addition is not associative at all. This call perform saturated additions in reverse incoming order.
  5. The summation is computed in a 'round toward \(-\infty\) mode. The result is guaranted to be less or equal to the exact one (except for Nans). Combined with strict the option ensures generally faster computation, but strict inequality.
  6. The summation is computed in a 'round toward \(\infty\) mode. The result is guaranted to be greater or equal to the exact one (except for Nans). Combined with strict the option ensures generally faster computation, but strict inequality.
  7. The summation is computed in the double sized element type (if available). This decorator has no effect on double and 64 bits integrals.
Note
Although the infix notation with + is supported for two parameters, the + operator on standard scalar types is the original one and so can lead to automatic promotion.

Example

// revision 0
#include <eve/module/core.hpp>
#include <iostream>
#include <iomanip>
#include <cfenv>
int main()
{
eve::wide wf0{1.0f, 1.0f, 2.0f, 3.0f, -1.0f, -2.0f, -3.0f, -4.0f};
eve::wide wf1{eve::eps(eve::as(1.0f))/4, -eve::eps(eve::as(1.0f))/4, 1.0f, -1.0f, 2.0f, -2.0f, 3.0f, -3.0f};
eve::wide wi0{0, 1, 2, 3, -1, -2, -3, -4};
eve::wide wi1{0, -4, 1, -1, 2, -2, 3, -3};
eve::wide<std::uint16_t, eve::fixed<8>> wu0{65534u, 65000u, 2u, 3u, 4u, 5u, 6u, 7u};
eve::wide<std::uint16_t, eve::fixed<8>> wu1{2u, 6u, 5u, 4u, 3u, 2u, 1u, 0u};
std::cout << std::setprecision(20) << "<- wf0 = " << wf0 << "\n";
std::cout << std::setprecision(20) << "<- wf1 = " << wf1 << "\n";
std::cout << "<- wi0 = " << wi0 << "\n";
std::cout << "<- wi1 = " << wi1 << "\n";
std::cout << "<- wu0 = " << wu0 << "\n";
std::cout << "<- wu1 = " << wu1 << "\n";
std::cout << "-> add(wf0, wf1) = " << eve::add(wf0, wf1) << "\n";
std::cout << "-> add[ignore_last(2)](wf0, wf1) = " << eve::add[eve::ignore_last(2)](wf0, wf1) << "\n";
std::cout << "-> add[wf0 != 0](wf0, wf1) = " << eve::add[wf0 != 0](wf0, wf1) << "\n";
std::cout << "-> add(wu0, wu1) = " << eve::add(wu0, wu1) << "\n";
std::cout << "-> add(wi0, wi1) = " << eve::add(wi0, wi1) << "\n";
std::cout << std::setprecision(20) << "-> add(wf0, wf1) = " << eve::add(wf0, wf1) << "\n";
std::cout << std::setprecision(20) << "-> add[lower](wf0, wf1) = " << eve::add[eve::lower](wf0, wf1) << "\n";
std::cout << std::setprecision(20) << "-> add[upper](wf0, wf1) = " << eve::add[eve::upper](wf0, wf1) << "\n";
std::cout << std::setprecision(20) << "-> add[lower][strict](wf0, wf1) = " << eve::add[eve::lower][eve::strict](wf0, wf1) << "\n";
std::cout << std::setprecision(20) << "-> add[upper][strict](wf0, wf1) = " << eve::add[eve::upper][eve::strict](wf0, wf1) << "\n";
std::cout << "-> add(wu0, wu1) = " << eve::add(wu0, wu1) << "\n";
std::cout << "-> add[widen](wu0, wu1) = " << eve::add[eve::widen](wu0, wu1) << "\n";
std::cout << "-> add(wf0, wf1) = " << eve::add(wf0, wf1) << "\n";
std::cout << "-> add[widen](wf0, wf1) = " << eve::add[eve::widen](wf0, wf1) << "\n";
}
constexpr auto eps
Computes a constant to the machine epsilon.
Definition eps.hpp:73
Lightweight type-wrapper.
Definition as.hpp:29
Conditional expression ignoring the k last lanes from a eve::simd_value.
Definition conditional.hpp:332
Wrapper for SIMD registers.
Definition wide.hpp:70