LSSTApplications  20.0.0
LSSTDataManagementBasePackage
PolymorphicValue.h
Go to the documentation of this file.
1 // -*- LSST-C++ -*-
2 /*
3  * This file is part of afw.
4  *
5  * Developed for the LSST Data Management System.
6  * This product includes software developed by the LSST Project
7  * (https://www.lsst.org).
8  * See the COPYRIGHT file at the top-level directory of this distribution
9  * for details of code ownership.
10  *
11  * This program is free software: you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation, either version 3 of the License, or
14  * (at your option) any later version.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program. If not, see <https://www.gnu.org/licenses/>.
23  */
24 
25 #ifndef LSST_AFW_TYPEHANDLING_POLYMORPHICVALUE_H
26 #define LSST_AFW_TYPEHANDLING_POLYMORPHICVALUE_H
27 
28 #include <memory>
29 
30 #include "lsst/pex/exceptions.h"
32 
33 namespace lsst {
34 namespace afw {
35 namespace typehandling {
36 
48 /*
49  * Note: I would like to disallow the empty state, as it serves no purpose,
50  * but I can't think of any other sensible post-move state.
51  */
52 class PolymorphicValue final {
53 public:
59  PolymorphicValue(Storable const& value);
60  ~PolymorphicValue() noexcept;
61 
74 
91  PolymorphicValue& operator=(PolymorphicValue const& other);
92  PolymorphicValue& operator=(PolymorphicValue&& other) noexcept;
93 
95  void swap(PolymorphicValue& other) noexcept;
96 
104  bool empty() const noexcept;
105 
114  operator Storable&();
115  operator Storable const&() const;
116  Storable& get();
117  Storable const& get() const;
118 
129  bool operator==(PolymorphicValue const& other) const noexcept;
130  bool operator!=(PolymorphicValue const& other) const noexcept { return !(*this == other); }
131 
140  std::size_t hash_value() const;
141 
142 private:
143  // unique_ptr would be more appropriate, but Storable::cloneStorable must return shared_ptr
145 };
146 
152 inline void swap(PolymorphicValue& lhs, PolymorphicValue& rhs) noexcept { lhs.swap(rhs); }
153 
154 } // namespace typehandling
155 } // namespace afw
156 } // namespace lsst
157 
158 namespace std {
166 template <>
167 struct hash<lsst::afw::typehandling::PolymorphicValue> {
170  size_t operator()(argument_type const& obj) const { return obj.hash_value(); }
171 };
172 
174 template <>
177  lhs.swap(rhs);
178 }
179 
180 } // namespace std
181 
182 #endif
std::shared_ptr
STL class.
std::hash< lsst::afw::typehandling::PolymorphicValue >::operator()
size_t operator()(argument_type const &obj) const
Definition: PolymorphicValue.h:170
lsst::afw
Definition: imageAlgorithm.dox:1
lsst::afw::typehandling::PolymorphicValue::empty
bool empty() const noexcept
Check whether this object contains a Storable.
Definition: PolymorphicValue.cc:62
lsst::afw::typehandling::Storable
Interface supporting iteration over heterogenous containers.
Definition: Storable.h:58
lsst::afw::typehandling::PolymorphicValue::swap
void swap(PolymorphicValue &other) noexcept
Exchange the contents of this container and another.
Definition: PolymorphicValue.cc:57
lsst::afw::typehandling::PolymorphicValue::PolymorphicValue
PolymorphicValue(Storable const &value)
Create a new object containing a copy of a Storable.
Definition: PolymorphicValue.cc:33
lsst::afw::typehandling::PolymorphicValue::~PolymorphicValue
~PolymorphicValue() noexcept
other
ItemVariant const * other
Definition: Schema.cc:56
Storable.h
lsst::afw::typehandling::swap
void swap(PolymorphicValue &lhs, PolymorphicValue &rhs) noexcept
Swap specialization for PolymorphicValue.
Definition: PolymorphicValue.h:152
lsst::afw::typehandling::PolymorphicValue
Container that passes Storable objects by value while preserving type.
Definition: PolymorphicValue.h:52
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
std::swap
T swap(T... args)
lsst::afw::typehandling::PolymorphicValue::get
Storable & get()
Return a reference to the internal Storable, if one exists.
Definition: PolymorphicValue.cc:66
lsst::afw::typehandling::PolymorphicValue::hash_value
std::size_t hash_value() const
Return a hash of this object (optional operation).
Definition: PolymorphicValue.cc:87
std
STL namespace.
std::size_t
exceptions.h
std::hash