Added size_t DPCTLContext_Hash(CtxRef)

Author: oleksandr-pavlyk

dpctl-capi/include/dpctl_sycl_context_interface.h

@@ -161,4 +161,15 @@ DPCTLContext_GetBackend(__dpctl_keep const DPCTLSyclContextRef CtxRef);
 DPCTL_API
 void DPCTLContext_Delete(__dpctl_take DPCTLSyclContextRef CtxRef);
 
+/*!
+ * @brief Wrapper over
+ * std::hash<sycl::context>'s operator()
+ *
+ * @param    CtxRef        The DPCTLSyclContextRef pointer.
+ * @return   Hash value of the underlying sycl::context instance.
+ * @ingroup ContextInterface
+ */
+DPCTL_API
+size_t DPCTLContext_Hash(__dpctl_take DPCTLSyclContextRef CtxRef);
+
 DPCTL_C_EXTERN_C_END

dpctl-capi/source/dpctl_sycl_context_interface.cpp

@@ -197,3 +197,17 @@ DPCTLContext_GetBackend(__dpctl_keep const DPCTLSyclContextRef CtxRef)
         return DPCTL_UNKNOWN_BACKEND;
     }
 }
+
+size_t DPCTLContext_Hash(__dpctl_keep const DPCTLSyclContextRef CtxRef)
+{
+    if (CtxRef) {
+        auto C = unwrap(CtxRef);
+        std::hash<context> hash_fn;
+        return hash_fn(*C);
+    }
+    else {
+        std::cerr << "Argument CtxRef is null"
+                  << "/n";
+        return 0;
+    }
+}

dpctl-capi/tests/test_sycl_context_interface.cpp

@@ -177,6 +177,8 @@ TEST_P(TestDPCTLContextInterface, ChkAreEq)
     EXPECT_NO_FATAL_FAILURE(are_not_eq = DPCTLContext_AreEq(CRef1, CRef3));
     EXPECT_TRUE(are_eq);
     EXPECT_FALSE(are_not_eq);
+    EXPECT_TRUE(DPCTLContext_Hash(CRef1) == DPCTLContext_Hash(CRef2));
+    EXPECT_FALSE(DPCTLContext_Hash(CRef1) == DPCTLContext_Hash(CRef3));
 
     EXPECT_NO_FATAL_FAILURE(DPCTLContext_Delete(CRef1));
     EXPECT_NO_FATAL_FAILURE(DPCTLContext_Delete(CRef2));