Add xtd::converter delegate

src/xtd.core/CMakeLists.txt

@@ -142,6 +142,8 @@ add_sources(
   include/xtd/convert_pointer
   include/xtd/convert_string.hpp
   include/xtd/convert_string
+  include/xtd/converter.hpp
+  include/xtd/converter
   include/xtd/cpp_language.hpp
   include/xtd/cpp_language
   include/xtd/ctrace.hpp

src/xtd.core/include/xtd/converter

@@ -0,0 +1,2 @@
+#pragma once
+#include "converter.hpp"

src/xtd.core/include/xtd/converter.hpp

@@ -0,0 +1,31 @@
+/// @file
+/// @brief Contains xtd::converter delegate.
+/// @copyright Copyright (c) 2025 Gammasoft. All rights reserved.
+#pragma once
+#include "delegate.hpp"
+#include "int32.hpp"
+
+/// @brief The xtd namespace contains all fundamental classes to access Hardware, Os, System, and more.
+namespace xtd {
+  /// @brief Represents a method that converts an object from one type to another type.
+  /// ```cpp
+  /// template<class output_t, class input_t>
+  /// using converter = xtd::delegate<output_t(input_t)>;
+  /// ```
+  /// @par Header
+  /// ```cpp
+  /// #include <xtd/converter>
+  /// ```
+  /// @par Namespace
+  /// xtd
+  /// @par Library
+  /// xtd.core
+  /// @ingroup xtd_core system
+  /// @tparam input_t The type of object that is to be converted. This type parameter is contravariant. That is, you can use either the type you specified or any type that is less derived.
+  /// @tparam output_t he type the input object is to be converted to. This type parameter is covariant. That is, you can use either the type you specified or any type that is more derived.
+  /// @param input The object to convert.
+  /// @return The `output_t` that represents the converted `input_t`.
+  /// @remarks This delegate is used by the xtd::array::convert_all method of the xtd::array class and the xtd::collections::generic::list::convert_all method of the xtd::collections::generic::list <type_t> class to convert each element of the collection from one type to another.
+  template<class output_t, class input_t>
+  using converter = xtd::delegate<output_t(input_t)>;
+}

src/xtd.core/include/xtd/xtd.core.hpp

@@ -309,6 +309,7 @@
 #include "convert.hpp"
 #include "convert_pointer.hpp"
 #include "convert_string.hpp"
+#include "converter.hpp"
 #include "core_export.hpp"
 #include "cpp_language.hpp"
 #include "ctrace.hpp"