LSSTApplications  19.0.0-14-gb0260a2+72efe9b372,20.0.0+7927753e06,20.0.0+8829bf0056,20.0.0+995114c5d2,20.0.0+b6f4b2abd1,20.0.0+bddc4f4cbe,20.0.0-1-g253301a+8829bf0056,20.0.0-1-g2b7511a+0d71a2d77f,20.0.0-1-g5b95a8c+7461dd0434,20.0.0-12-g321c96ea+23efe4bbff,20.0.0-16-gfab17e72e+fdf35455f6,20.0.0-2-g0070d88+ba3ffc8f0b,20.0.0-2-g4dae9ad+ee58a624b3,20.0.0-2-g61b8584+5d3db074ba,20.0.0-2-gb780d76+d529cf1a41,20.0.0-2-ged6426c+226a441f5f,20.0.0-2-gf072044+8829bf0056,20.0.0-2-gf1f7952+ee58a624b3,20.0.0-20-geae50cf+e37fec0aee,20.0.0-25-g3dcad98+544a109665,20.0.0-25-g5eafb0f+ee58a624b3,20.0.0-27-g64178ef+f1f297b00a,20.0.0-3-g4cc78c6+e0676b0dc8,20.0.0-3-g8f21e14+4fd2c12c9a,20.0.0-3-gbd60e8c+187b78b4b8,20.0.0-3-gbecbe05+48431fa087,20.0.0-38-ge4adf513+a12e1f8e37,20.0.0-4-g97dc21a+544a109665,20.0.0-4-gb4befbc+087873070b,20.0.0-4-gf910f65+5d3db074ba,20.0.0-5-gdfe0fee+199202a608,20.0.0-5-gfbfe500+d529cf1a41,20.0.0-6-g64f541c+d529cf1a41,20.0.0-6-g9a5b7a1+a1cd37312e,20.0.0-68-ga3f3dda+5fca18c6a4,20.0.0-9-g4aef684+e18322736b,w.2020.45
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
std::hash
exceptions.h