uuid_t: Add uuid_t::equivalent(..) method fo relaxed comparison on different uuid_t; Add API doc to uuid_t::operator==(..) ..

The operator uuid_t::operator==(..) and uuid_t::operator!=(..)
perform strict comparison and will fail on different uuid_t types (TypeSize).

Adding convenient relaxed uuid_t::equivalent(..) method,
allowing conversion to uuid128_t in case of different types
before comparison.

Tested with test_uuid.cpp

1 files changed, 10 insertions, 0 deletions

diff --git a/src/uuid.cpp b/src/uuid.cpp
index 879ba57..8bd954b 100644
--- a/src/uuid.cpp
+++ b/src/uuid.cpp
@@ -91,6 +91,16 @@ std::unique_ptr<uuid_t> uuid_t::clone() const noexcept {
     abort(); // never reached
 }
 
+bool uuid_t::equivalent(uuid_t const &o) const noexcept {
+    if( this == &o ) {
+        return true;
+    }
+    if( getTypeSize() == o.getTypeSize() ) {
+        return *this == o;
+    }
+    return toUUID128() == o.toUUID128();
+}
+
 uuid128_t uuid_t::toUUID128(uuid128_t const & base_uuid, jau::nsize_t const uuid32_le_octet_index) const noexcept {
     switch(type) {
         case TypeSize::UUID16_SZ:  return uuid128_t( *( static_cast<const uuid16_t*>(this)  ), base_uuid, uuid32_le_octet_index);