micro-test-plus 5.0.0
µTest++ Testing Framework
Loading...
Searching...
No Matches
micro_os_plus::micro_test_plus::detail::eq_< Lhs_T, Rhs_T > Struct Template Reference

Equality comparator struct template. More...

#include <micro-os-plus/micro-test-plus.h>

Inheritance diagram for micro_os_plus::micro_test_plus::detail::eq_< Lhs_T, Rhs_T >:

Public Member Functions

constexpr eq_ (const Lhs_T &lhs={}, const Rhs_T &rhs={})
 Constructs an equality comparator for the given operands.
constexpr auto lhs (void) const
 Retrieves the left-hand operand.
constexpr operator bool () const
 Conversion operator to boolean.
constexpr auto rhs (void) const
 Retrieves the right-hand operand.

Private Attributes

const Lhs_T lhs_ {}
 Stores the left-hand operand.
const Rhs_T rhs_ {}
 Stores the right-hand operand.
const bool value_ {}
 Stores the result of the comparison.

Detailed Description

template<class Lhs_T, class Rhs_T>
struct micro_os_plus::micro_test_plus::detail::eq_< Lhs_T, Rhs_T >

Derived from binary_op_, this struct checks whether the left-hand operand is equal to the right-hand operand. It is used within test expressions to provide human-readable equality assertions with enhanced reporting of the actual and expected values upon failure.

Template Parameters
Lhs_TThe type of the left-hand operand.
Rhs_TThe type of the right-hand operand.

Definition at line 305 of file detail.h.

Constructor & Destructor Documentation

◆ eq_()

template<class Lhs_T, class Rhs_T>
micro_os_plus::micro_test_plus::detail::eq_< Lhs_T, Rhs_T >::eq_ ( const Lhs_T & lhs = {},
const Rhs_T & rhs = {} )
constexpr
Parameters
lhsThe left-hand operand.
rhsThe right-hand operand.

Evaluates the equality of lhs and rhs inside an immediately invoked lambda and passes the boolean result to the binary_op_ base class constructor. Supports types with static value members, types with an epsilon precision member, and generic types.

Definition at line 190 of file detail-inlines.h.

192 {
193 // This lambda is called in the constructor to evaluate the
194 // comparison. Its result is implicitly converted to bool via
195 // the operator bool() of whatever type the branch returns.
196 // This is intentional: all result types (integral_constant,
197 // comparator objects, plain bool) define operator bool().
198 using std::operator==;
199 using std::operator<;
200
201#if defined(__GNUC__)
202#pragma GCC diagnostic push
203#pragma GCC diagnostic ignored "-Wfloat-equal"
204#pragma GCC diagnostic ignored "-Wconversion"
205#pragma GCC diagnostic ignored "-Wdouble-promotion"
206#pragma GCC diagnostic ignored "-Wsign-compare"
207#if defined(__clang__)
208#pragma clang diagnostic ignored "-Wimplicit-int-float-conversion"
209#pragma clang diagnostic ignored "-Wpedantic"
210#endif
211#endif
214 {
215 // If both types have values (like numeric constants),
216 // compare them directly.
217 return Lhs_T::value == Rhs_T::value;
218 }
219 else if constexpr (type_traits::has_epsilon<Lhs_T>
221 {
222 // If both values have precision, compare them using
223 // the smallest precision.
224 return math::abs (get (lhs) - get (rhs))
225 < math::min_value (lhs.epsilon, rhs.epsilon);
226 }
227 else if constexpr (type_traits::has_epsilon<Lhs_T>)
228 {
229 // If only the left operand has precision, use it.
230 return math::abs (get (lhs) - get (rhs)) < lhs.epsilon;
231 }
232 else if constexpr (type_traits::has_epsilon<Rhs_T>)
233 {
234 // If only the right operand has precision, use it.
235 return math::abs (get (lhs) - get (rhs)) < rhs.epsilon;
236 }
237 else
238 {
239 // Call the generic getters, which might
240 // either call the type get() or return the value.
241 return get (lhs) == get (rhs);
242 }
243#if defined(__GNUC__)
244#pragma GCC diagnostic pop
245#endif
246 }() }
247 {
248 }
constexpr auto get(const T &t)
Generic getter function template for value retrieval.
constexpr auto min_value(const T &lhs, const T &rhs) noexcept -> const T &
Computes the minimum of two comparable values.
constexpr auto abs(const T t) noexcept -> T
Computes the absolute value of a given comparable value.
constexpr auto lhs(void) const
Retrieves the left-hand operand.
constexpr binary_op_(const Lhs_T &lhs, const Rhs_T &rhs, bool value)
Constructs a binary comparator with the given operands and pre-computed result.
constexpr auto rhs(void) const
Retrieves the right-hand operand.
Equality comparator struct template.
Definition detail.h:306

References micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::binary_op_(), micro_os_plus::micro_test_plus::math::abs(), micro_os_plus::micro_test_plus::detail::get(), micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::lhs(), micro_os_plus::micro_test_plus::math::min_value(), and micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::rhs().

Member Function Documentation

◆ lhs()

template<class Lhs_T, class Rhs_T>
auto micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::lhs ( void ) const
nodiscardconstexprinherited
Parameters
None.
Returns
The extracted left-hand operand.

Returns the value of the left-hand operand, applying the generic getter to ensure correct extraction for both custom and standard types.

Definition at line 162 of file detail-inlines.h.

163 {
164 return get (lhs_);
165 }
const Lhs_T lhs_
Stores the left-hand operand.
Definition detail.h:272

References micro_os_plus::micro_test_plus::detail::get(), and lhs_.

Referenced by micro_os_plus::micro_test_plus::detail::and_< Lhs_T, Rhs_T >::and_(), binary_op_(), micro_os_plus::micro_test_plus::detail::eq_< Lhs_T, Rhs_T >::eq_(), micro_os_plus::micro_test_plus::detail::ge_< Lhs_T, Rhs_T >::ge_(), micro_os_plus::micro_test_plus::detail::gt_< Lhs_T, Rhs_T >::gt_(), micro_os_plus::micro_test_plus::detail::le_< Lhs_T, Rhs_T >::le_(), micro_os_plus::micro_test_plus::detail::lt_< Lhs_T, Rhs_T >::lt_(), micro_os_plus::micro_test_plus::detail::ne_< Lhs_T, Rhs_T >::ne_(), micro_os_plus::micro_test_plus::detail::or_< Lhs_T, Rhs_T >::or_(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), and micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<().

◆ operator bool()

template<class Lhs_T, class Rhs_T>
micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::operator bool ( ) const
nodiscardconstexprinherited
Parameters
None.
Returns
The result of the comparison.

Returns the pre-computed boolean result stored by the derived comparator's constructor.

Definition at line 148 of file detail-inlines.h.

150 {
151 return value_;
152 }
const bool value_
Stores the result of the comparison.
Definition detail.h:285

References binary_op_(), and value_.

◆ rhs()

template<class Lhs_T, class Rhs_T>
auto micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::rhs ( void ) const
nodiscardconstexprinherited
Parameters
None.
Returns
The extracted right-hand operand.

Returns the value of the right-hand operand, applying the generic getter to ensure correct extraction for both custom and standard types.

Definition at line 175 of file detail-inlines.h.

176 {
177 return get (rhs_);
178 }
const Rhs_T rhs_
Stores the right-hand operand.
Definition detail.h:280

References micro_os_plus::micro_test_plus::detail::get(), and rhs_.

Referenced by micro_os_plus::micro_test_plus::detail::and_< Lhs_T, Rhs_T >::and_(), binary_op_(), micro_os_plus::micro_test_plus::detail::eq_< Lhs_T, Rhs_T >::eq_(), micro_os_plus::micro_test_plus::detail::ge_< Lhs_T, Rhs_T >::ge_(), micro_os_plus::micro_test_plus::detail::gt_< Lhs_T, Rhs_T >::gt_(), micro_os_plus::micro_test_plus::detail::le_< Lhs_T, Rhs_T >::le_(), micro_os_plus::micro_test_plus::detail::lt_< Lhs_T, Rhs_T >::lt_(), micro_os_plus::micro_test_plus::detail::ne_< Lhs_T, Rhs_T >::ne_(), micro_os_plus::micro_test_plus::detail::or_< Lhs_T, Rhs_T >::or_(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<(), and micro_os_plus::micro_test_plus::detail::expression_formatter::operator<<().

Member Data Documentation

◆ lhs_

template<class Lhs_T, class Rhs_T>
const Lhs_T micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::lhs_ {}
privateinherited
Note
Operands are stored by value; passing a large container will copy it into this member.

Definition at line 272 of file detail.h.

272{};

Referenced by binary_op_(), and lhs().

◆ rhs_

template<class Lhs_T, class Rhs_T>
const Rhs_T micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::rhs_ {}
privateinherited
Note
Operands are stored by value; passing a large container will copy it into this member.

Definition at line 280 of file detail.h.

280{};

Referenced by binary_op_(), and rhs().

◆ value_

template<class Lhs_T, class Rhs_T>
const bool micro_os_plus::micro_test_plus::detail::binary_op_< Lhs_T, Rhs_T >::value_ {}
privateinherited

Definition at line 285 of file detail.h.

285{};

Referenced by binary_op_(), and operator bool().


The documentation for this struct was generated from the following files: