LSST Applications  21.0.0+04719a4bac,21.0.0-1-ga51b5d4+f5e6047307,21.0.0-11-g2b59f77+a9c1acf22d,21.0.0-11-ga42c5b2+86977b0b17,21.0.0-12-gf4ce030+76814010d2,21.0.0-13-g1721dae+760e7a6536,21.0.0-13-g3a573fe+768d78a30a,21.0.0-15-g5a7caf0+f21cbc5713,21.0.0-16-g0fb55c1+b60e2d390c,21.0.0-19-g4cded4ca+71a93a33c0,21.0.0-2-g103fe59+bb20972958,21.0.0-2-g45278ab+04719a4bac,21.0.0-2-g5242d73+3ad5d60fb1,21.0.0-2-g7f82c8f+8babb168e8,21.0.0-2-g8f08a60+06509c8b61,21.0.0-2-g8faa9b5+616205b9df,21.0.0-2-ga326454+8babb168e8,21.0.0-2-gde069b7+5e4aea9c2f,21.0.0-2-gecfae73+1d3a86e577,21.0.0-2-gfc62afb+3ad5d60fb1,21.0.0-25-g1d57be3cd+e73869a214,21.0.0-3-g357aad2+ed88757d29,21.0.0-3-g4a4ce7f+3ad5d60fb1,21.0.0-3-g4be5c26+3ad5d60fb1,21.0.0-3-g65f322c+e0b24896a3,21.0.0-3-g7d9da8d+616205b9df,21.0.0-3-ge02ed75+a9c1acf22d,21.0.0-4-g591bb35+a9c1acf22d,21.0.0-4-g65b4814+b60e2d390c,21.0.0-4-gccdca77+0de219a2bc,21.0.0-4-ge8a399c+6c55c39e83,21.0.0-5-gd00fb1e+05fce91b99,21.0.0-6-gc675373+3ad5d60fb1,21.0.0-64-g1122c245+4fb2b8f86e,21.0.0-7-g04766d7+cd19d05db2,21.0.0-7-gdf92d54+04719a4bac,21.0.0-8-g5674e7b+d1bd76f71f,master-gac4afde19b+a9c1acf22d,w.2021.13
LSST Data Management Base Package
Flag.h
Go to the documentation of this file.
1 // -*- lsst-c++ -*-
2 #ifndef LSST_AFW_TABLE_Flag_h_INCLUDED
3 #define LSST_AFW_TABLE_Flag_h_INCLUDED
4 
5 #include <cstdint>
6 
8 
9 #include "lsst/afw/table/misc.h"
11 #include "lsst/afw/table/KeyBase.h"
12 
13 namespace lsst {
14 namespace afw {
15 namespace table {
16 
17 namespace detail {
18 
19 class Access;
20 
21 } // namespace detail
22 
32 template <>
33 struct FieldBase<Flag> {
34  typedef bool Value;
36 
38  int getElementCount() const { return 1; }
39 
41  static std::string getTypeString() { return "Flag"; }
42 
43  // Only the first of these constructors is valid for this specializations, but
44  // it's convenient to be able to instantiate both, since the other is used
45  // by other specializations.
46  FieldBase() = default;
47  FieldBase(int) {
49  "Constructor disabled (this Field type is not sized).");
50  }
51 
52  FieldBase(FieldBase const &) = default;
53  FieldBase(FieldBase &&) = default;
54  FieldBase &operator=(FieldBase const &) = default;
55  FieldBase &operator=(FieldBase &&) = default;
56  ~FieldBase() = default;
57 
58 protected:
60  void stream(std::ostream &os) const {}
61 };
62 
66 template <>
67 class KeyBase<Flag> {
68 public:
69  static bool const HAS_NAMED_SUBFIELDS = false;
70 
72  Key<FieldBase<Flag>::Element> getStorage() const;
73 
74  KeyBase() = default;
75  KeyBase(KeyBase const &) = default;
76  KeyBase(KeyBase &&) = default;
77  KeyBase &operator=(KeyBase const &) = default;
78  KeyBase &operator=(KeyBase &&) = default;
79  ~KeyBase() = default;
80 };
81 
93 template <>
94 class Key<Flag> : public KeyBase<Flag>, public FieldBase<Flag> {
95 public:
97 
106  template <typename OtherT>
107  bool operator==(Key<OtherT> const &other) const {
108  return false;
109  }
110  template <typename OtherT>
111  bool operator!=(Key<OtherT> const &other) const {
112  return true;
113  }
114 
115  bool operator==(Key const &other) const { return _offset == other._offset && _bit == other._bit; }
116  bool operator!=(Key const &other) const { return !this->operator==(other); }
118 
120  std::size_t hash_value() const noexcept {
121  // Completely arbitrary seed
122  return utils::hashCombine(17, _offset, _bit);
123  }
124 
126  int getOffset() const { return _offset; }
127 
129  int getBit() const { return _bit; }
130 
139  bool isValid() const { return _offset >= 0; }
140 
146  Key() : FieldBase<Flag>(), _offset(-1), _bit(0) {}
147 
148  Key(Key const &) = default;
149  Key(Key &&) = default;
150  Key &operator=(Key const &) = default;
151  Key &operator=(Key &&) = default;
152  ~Key() = default;
153 
155  inline friend std::ostream &operator<<(std::ostream &os, Key<Flag> const &key) {
156  return os << "Key['" << Key<Flag>::getTypeString() << "'](offset=" << key.getOffset()
157  << ", bit=" << key.getBit() << ")";
158  }
159 
160 private:
161  friend class detail::Access;
162  friend class BaseRecord;
163 
165  Value getValue(Element const *p, ndarray::Manager::Ptr const &) const {
166  return (*p) & (Element(1) << _bit);
167  }
168 
170  void setValue(Element *p, ndarray::Manager::Ptr const &, Value v) const {
171  if (v) {
172  *p |= (Element(1) << _bit);
173  } else {
174  *p &= ~(Element(1) << _bit);
175  }
176  }
177 
178  explicit Key(int offset, int bit) : _offset(offset), _bit(bit) {}
179 
180  int _offset;
181  int _bit;
182 };
183 } // namespace table
184 } // namespace afw
185 } // namespace lsst
186 
187 namespace std {
188 template <>
189 struct hash<lsst::afw::table::Key<lsst::afw::table::Flag>> {
192  size_t operator()(argument_type const &obj) const noexcept { return obj.hash_value(); }
193 };
194 } // namespace std
195 
196 #endif // !LSST_AFW_TABLE_Flag_h_INCLUDED
#define LSST_EXCEPT(type,...)
Create an exception with a given type.
Definition: Exception.h:48
ItemVariant const * other
Definition: Schema.cc:56
Key< U > key
Definition: Schema.cc:281
std::ostream * os
Definition: Schema.cc:746
Base class for all records.
Definition: BaseRecord.h:31
Key specialization for Flag.
Definition: Flag.h:94
bool isValid() const
Return true if the key was initialized to valid offset.
Definition: Flag.h:139
Key(Key const &)=default
int getOffset() const
Return the offset in bytes of the integer element that holds this field's bit.
Definition: Flag.h:126
bool operator==(Key< OtherT > const &other) const
Equality comparison.
Definition: Flag.h:107
Key()
Default construct a field.
Definition: Flag.h:146
bool operator==(Key const &other) const
Definition: Flag.h:115
Key & operator=(Key &&)=default
bool operator!=(Key< OtherT > const &other) const
Definition: Flag.h:111
bool operator!=(Key const &other) const
Definition: Flag.h:116
int getBit() const
The index of this field's bit within the integer it shares with other Flag fields.
Definition: Flag.h:129
Key & operator=(Key const &)=default
std::size_t hash_value() const noexcept
Return a hash of this object.
Definition: Flag.h:120
friend std::ostream & operator<<(std::ostream &os, Key< Flag > const &key)
Stringification.
Definition: Flag.h:155
KeyBase(KeyBase const &)=default
KeyBase & operator=(KeyBase &&)=default
KeyBase & operator=(KeyBase const &)=default
A base class for Key that allows subfield keys to be extracted for some field types.
Definition: KeyBase.h:20
static bool const HAS_NAMED_SUBFIELDS
Definition: KeyBase.h:22
A class used as a handle to a particular field in a table.
Definition: Key.h:53
bool operator==(Key< OtherT > const &other) const noexcept
Equality comparison.
Definition: Key.h:66
Key() noexcept
Default construct a field.
Definition: Key.h:104
Reports errors in the logical structure of the program.
Definition: Runtime.h:46
std::size_t hashCombine(std::size_t seed) noexcept
Combine hashes.
Definition: hashCombine.h:35
A base class for image defects.
STL namespace.
FieldBase & operator=(FieldBase const &)=default
std::int64_t Element
the actual storage type (shared by multiple flag fields)
Definition: Flag.h:35
void stream(std::ostream &os) const
Defines how fields are printed.
Definition: Flag.h:60
static std::string getTypeString()
Return a string description of the field type.
Definition: Flag.h:41
FieldBase(FieldBase &&)=default
int getElementCount() const
Return the number of subfield elements (always one for scalars).
Definition: Flag.h:38
bool Value
the type returned by BaseRecord::get
Definition: Flag.h:34
FieldBase(FieldBase const &)=default
FieldBase & operator=(FieldBase &&)=default
Field base class default implementation (used for numeric scalars and lsst::geom::Angle).
Definition: FieldBase.h:43
static std::string getTypeString()
Return a string description of the field type.
Definition: FieldBase.cc:56
Value getValue(Element const *p, ndarray::Manager::Ptr const &) const
Used to implement BaseRecord::get.
Definition: FieldBase.h:83
T Element
the type of subfields (the same as the type itself for scalars)
Definition: FieldBase.h:47
T Value
the type returned by BaseRecord::get
Definition: FieldBase.h:44
void setValue(Element *p, ndarray::Manager::Ptr const &, Value v) const
Used to implement BaseRecord::set.
Definition: FieldBase.h:86
size_t operator()(argument_type const &obj) const noexcept
Definition: Flag.h:192