Add DPCTLPlatformMgr_GetInfo function

Author: vlad-perevezentsev

dpctl/_backend.pxd

@@ -263,6 +263,7 @@ cdef extern from "syclinterface/dpctl_sycl_platform_manager.h":
         DPCTLPlatformVectorRef,
         size_t index)
     cdef void DPCTLPlatformMgr_PrintInfo(const DPCTLSyclPlatformRef, size_t)
+    cdef const char *DPCTLPlatformMgr_GetInfo(const DPCTLSyclPlatformRef, size_t)
 
 
 cdef extern from "syclinterface/dpctl_sycl_platform_interface.h":

libsyclinterface/include/dpctl_sycl_platform_manager.h

@@ -64,6 +64,30 @@ DPCTL_API
 void DPCTLPlatformMgr_PrintInfo(__dpctl_keep const DPCTLSyclPlatformRef PRef,
                                 size_t verbosity);
 
+/*!
+ * @brief Returns a set of platform info attributes as a string.
+ *
+ * The helper function is used to get metadata about a given platform. The
+ * amount of information received is controlled by the verbosity level.
+ *
+ * Verbosity level 0: Returns only the name of the platform.
+ * Verbosity level 1: Returns the name, version, vendor, backend, number of
+ *                    devices in the platform.
+ * Verbosity level 2: Returns everything in level 1 and also returns the name,
+ *                    version, and filter string for each device in the
+ *                    platform.
+ *
+ * @param    PRef           A #DPCTLSyclPlatformRef opaque pointer.
+ * @param    verbosity      Verbosilty level to control how much information is
+ *                          printed out.
+ * @return   A formatted C string capturing the information about the
+ *           sycl::platform argument.
+ */
+DPCTL_API
+__dpctl_give const char *
+DPCTLPlatformMgr_GetInfo(__dpctl_keep const DPCTLSyclPlatformRef PRef,
+                         size_t verbosity);
+
 /*! @} */
 
 DPCTL_C_EXTERN_C_END

libsyclinterface/source/dpctl_sycl_platform_manager.cpp

@@ -27,6 +27,7 @@
 #include "dpctl_sycl_platform_manager.h"
 #include "Support/CBindingWrapping.h"
 #include "dpctl_error_handlers.h"
+#include "dpctl_string_utils.hpp"
 #include "dpctl_sycl_platform_interface.h"
 #include "dpctl_utils_helper.h"
 #include <CL/sycl.hpp>
@@ -41,7 +42,7 @@ namespace
 {
 DEFINE_SIMPLE_CONVERSION_FUNCTIONS(platform, DPCTLSyclPlatformRef);
 
-void platform_print_info_impl(const platform &p, size_t verbosity)
+std::string platform_print_info_impl(const platform &p, size_t verbosity)
 {
     std::stringstream ss;
 
@@ -96,7 +97,7 @@ void platform_print_info_impl(const platform &p, size_t verbosity)
             }
     }
 
-    std::cout << ss.str();
+    return ss.str();
 }
 
 } // namespace
@@ -111,10 +112,27 @@ void DPCTLPlatformMgr_PrintInfo(__dpctl_keep const DPCTLSyclPlatformRef PRef,
 {
     auto p = unwrap(PRef);
     if (p) {
-        platform_print_info_impl(*p, verbosity);
+        std::cout << platform_print_info_impl(*p, verbosity);
     }
     else {
         error_handler("Platform reference is NULL.", __FILE__, __func__,
                       __LINE__);
     }
 }
+
+__dpctl_give const char *
+DPCTLPlatformMgr_GetInfo(__dpctl_keep const DPCTLSyclPlatformRef PRef,
+                         size_t verbosity)
+{
+    const char *cstr_info = nullptr;
+    auto p = unwrap(PRef);
+    if (p) {
+        auto infostr = platform_print_info_impl(*p, verbosity);
+        cstr_info = dpctl::helper::cstring_from_string(infostr);
+    }
+    else {
+        error_handler("Platform reference is NULL.", __FILE__, __func__,
+                      __LINE__);
+    }
+    return cstr_info;
+}