#pragma once #include #include #include #include "drake/common/drake_copyable.h" #include "drake/common/fmt_ostream.h" #include "drake/common/hash.h" #include "drake/common/reset_after_move.h" namespace drake { namespace solvers { /** Identifies a SolverInterface implementation. A moved-from instance is guaranteed to be empty and will not compare equal to any non-empty ID. */ class SolverId { public: DRAKE_DEFAULT_COPY_AND_MOVE_AND_ASSIGN(SolverId) ~SolverId() = default; /** Constructs a specific, known solver type. Internally, a hidden integer is allocated and assigned to this instance; all instances that share an integer (including copies of this instance) are considered equal. The solver names are not enforced to be unique, though we recommend that they remain so in practice. For best performance, choose a name that is 15 characters or less, so that it fits within the libstdc++ "small string" optimization ("SSO"). */ explicit SolverId(std::string name); const std::string& name() const { return name_; } /** Implements the @ref hash_append concept. */ template friend void hash_append(HashAlgorithm& hasher, const SolverId& item) noexcept { using drake::hash_append; hash_append(hasher, int{item.id_}); // We do not send the name_ to the hasher, because the id_ is already // unique across all instances. } private: friend bool operator==(const SolverId&, const SolverId&); friend bool operator!=(const SolverId&, const SolverId&); friend struct std::less; reset_after_move id_; std::string name_; }; bool operator==(const SolverId&, const SolverId&); bool operator!=(const SolverId&, const SolverId&); std::ostream& operator<<(std::ostream&, const SolverId&); } // namespace solvers } // namespace drake namespace std { /* Provides std::less. */ template <> struct less { bool operator()(const drake::solvers::SolverId& lhs, const drake::solvers::SolverId& rhs) const { return lhs.id_ < rhs.id_; } }; /* Provides std::hash. */ template <> struct hash : public drake::DefaultHash {}; } // namespace std // TODO(jwnimmer-tri) Add a real formatter and deprecate the operator<<. namespace fmt { template <> struct formatter : drake::ostream_formatter {}; } // namespace fmt