cloneable.hpp

Go to the documentation of this file.

// Copyright (c) 2014-2023, Lawrence Livermore National Security, LLC.
// Produced at the Lawrence Livermore National Laboratory.
// Written by the LBANN Research Team (B. Van Essen, et al.) listed in
// the CONTRIBUTORS file. <lbann-dev@llnl.gov>
//
// LLNL-CODE-697807.
// All rights reserved.
//
// This file is part of LBANN: Livermore Big Artificial Neural Network
// Toolkit. For details, see http://software.llnl.gov/LBANN or
// https://github.com/LLNL/LBANN.
//
// Licensed under the Apache License, Version 2.0 (the "Licensee"); you
// may not use this file except in compliance with the License.  You may
// obtain a copy of the License at:
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
// implied. See the License for the specific language governing
// permissions and limitations under the license.
#ifndef LBANN_UTILS_CLONEABLE_HPP_INCLUDED
#define LBANN_UTILS_CLONEABLE_HPP_INCLUDED

#include <h2/meta/core/SFINAE.hpp>
#include <memory>
#include <type_traits>
#include <vector>

namespace lbann {

template <typename Base>
struct AsVirtualBase : virtual Base
{
  using Base::Base;
};

template <typename T>
struct HasAbstractFunction
{
};

template <typename T>
using NonLeafClass = HasAbstractFunction<T>;

template <typename T, typename... Base>
class Cloneable : public Base...
{
public:
  std::unique_ptr<T> clone() const
  {
    return std::unique_ptr<T>{static_cast<T*>(this->do_clone_())};
  }

private:
  virtual Cloneable* do_clone_() const override
  {
    return new T(static_cast<T const&>(*this));
  }
}; // class Cloneable

template <typename T, typename Base>
class Cloneable<T, Base> : public Base
{
public:
  std::unique_ptr<T> clone() const
  {
    return std::unique_ptr<T>{static_cast<T*>(this->do_clone_())};
  }

protected:
  using Base::Base;

private:
  virtual Cloneable* do_clone_() const override
  {
    return new T(static_cast<T const&>(*this));
  }
}; // class Cloneable

template <typename T>
class Cloneable<T>
{
public:
  virtual ~Cloneable() = default;

  std::unique_ptr<T> clone() const
  {
    return std::unique_ptr<T>{static_cast<T*>(this->do_clone_())};
  }

private:
  Cloneable* do_clone_() const { return new T(static_cast<T const&>(*this)); }
}; // class Cloneable<T>

template <typename T, typename... Base>
class Cloneable<HasAbstractFunction<T>, Base...> : public Base...
{
public:
  std::unique_ptr<T> clone() const
  {
    return std::unique_ptr<T>{static_cast<T*>(this->do_clone_())};
  }

private:
  virtual Cloneable* do_clone_() const = 0;
};

template <typename T, typename Base>
class Cloneable<HasAbstractFunction<T>, Base> : public Base
{
public:
  std::unique_ptr<T> clone() const
  {
    return std::unique_ptr<T>{static_cast<T*>(this->do_clone_())};
  }

protected:
  using Base::Base;

private:
  virtual Cloneable* do_clone_() const = 0;
};

template <typename T>
class Cloneable<HasAbstractFunction<T>>
{
public:
  virtual ~Cloneable() = default;

  std::unique_ptr<T> clone() const
  {
    return std::unique_ptr<T>{static_cast<T*>(this->do_clone_())};
  }

private:
  virtual Cloneable* do_clone_() const = 0;
}; // class Cloneable<T>

template <typename T>
struct IsCloneableT;

#ifndef DOXYGEN_SHOULD_SKIP_THIS
// The obvious case; I'd be concerned if this were ever called.
template <typename... Ts>
struct IsCloneableT<Cloneable<Ts...>> : std::true_type
{
};

namespace details {

struct definitely_not_a_unique_ptr;

template <typename T>
auto has_right_clone(T const& x) -> decltype(x.clone());

definitely_not_a_unique_ptr has_right_clone(...);

} // namespace details

template <typename T>
struct IsCloneableT
  : std::is_same<decltype(details::has_right_clone(std::declval<T>())),
                 std::unique_ptr<T>>
{
};
#endif // DOXYGEN_SHOULD_SKIP_THIS

template <typename T>
constexpr bool IsCloneable_v()
{
  return IsCloneableT<T>::value;
};

template <typename T>
inline constexpr bool IsCloneable = IsCloneable_v<T>();

template <typename T>
struct IsCloneablePtrT : std::false_type
{
};

template <typename T>
struct IsCloneablePtrT<T*> : IsCloneableT<std::remove_cv_t<T>>
{
};

template <typename T>
struct IsCloneablePtrT<std::shared_ptr<T>> : IsCloneableT<std::remove_cv_t<T>>
{
};

template <typename T, typename DeleterT>
struct IsCloneablePtrT<std::unique_ptr<T, DeleterT>>
  : IsCloneableT<std::remove_cv_t<T>>
{
};

template <typename T>
constexpr bool IsCloneablePtr_v()
{
  return IsCloneablePtrT<T>::value;
}

template <typename T>
inline constexpr bool IsCloneablePtr = IsCloneablePtr_v<T>();

template <typename T, typename... Bases>
using AbstractCloneableBase = Cloneable<HasAbstractFunction<T>, Bases...>;

template <typename CloneablePtrT,
          h2::meta::EnableWhen<IsCloneablePtr<CloneablePtrT>, int> = 1>
auto clone_all(std::vector<CloneablePtrT> const& things)
{
  std::vector<CloneablePtrT> cloned_things;
  cloned_things.reserve(things.size());
  for (auto const& t : things) {
    if (t)
      cloned_things.emplace_back(t->clone());
    else
      cloned_things.emplace_back(nullptr);
  }
  return cloned_things;
}

} // namespace lbann
#endif // LBANN_UTILS_CLONEABLE_HPP_INCLUDED