LSST Applications  21.0.0-147-g0e635eb1+1acddb5be5,22.0.0+052faf71bd,22.0.0+1ea9a8b2b2,22.0.0+6312710a6c,22.0.0+729191ecac,22.0.0+7589c3a021,22.0.0+9f079a9461,22.0.1-1-g7d6de66+b8044ec9de,22.0.1-1-g87000a6+536b1ee016,22.0.1-1-g8e32f31+6312710a6c,22.0.1-10-gd060f87+016f7cdc03,22.0.1-12-g9c3108e+df145f6f68,22.0.1-16-g314fa6d+c825727ab8,22.0.1-19-g93a5c75+d23f2fb6d8,22.0.1-19-gb93eaa13+aab3ef7709,22.0.1-2-g8ef0a89+b8044ec9de,22.0.1-2-g92698f7+9f079a9461,22.0.1-2-ga9b0f51+052faf71bd,22.0.1-2-gac51dbf+052faf71bd,22.0.1-2-gb66926d+6312710a6c,22.0.1-2-gcb770ba+09e3807989,22.0.1-20-g32debb5+b8044ec9de,22.0.1-23-gc2439a9a+fb0756638e,22.0.1-3-g496fd5d+09117f784f,22.0.1-3-g59f966b+1e6ba2c031,22.0.1-3-g849a1b8+f8b568069f,22.0.1-3-gaaec9c0+c5c846a8b1,22.0.1-32-g5ddfab5d3+60ce4897b0,22.0.1-4-g037fbe1+64e601228d,22.0.1-4-g8623105+b8044ec9de,22.0.1-5-g096abc9+d18c45d440,22.0.1-5-g15c806e+57f5c03693,22.0.1-7-gba73697+57f5c03693,master-g6e05de7fdc+c1283a92b8,master-g72cdda8301+729191ecac,w.2021.39
LSST Data Management Base Package
Field.h
Go to the documentation of this file.
1 // -*- lsst-c++ -*-
2 #ifndef AFW_TABLE_Field_h_INCLUDED
3 #define AFW_TABLE_Field_h_INCLUDED
4 
5 #include <iostream>
6 
8 
9 namespace lsst {
10 namespace afw {
11 namespace table {
12 
23 template <typename T>
24 struct Field : public FieldBase<T> {
26  using Element = typename FieldBase<T>::Element;
27 
44  Field(std::string const& name, std::string const& doc, std::string const& units = "",
45  FieldBase<T> const& size = FieldBase<T>())
46  : FieldBase<T>(size), _name(name), _doc(doc), _units(units) {}
47 
61  Field(std::string const& name, std::string const& doc, FieldBase<T> const& size)
62  : FieldBase<T>(size), _name(name), _doc(doc), _units() {}
63 
64  Field(Field const&) = default;
65  Field(Field&&) noexcept = default;
66  Field& operator=(Field const&) = default;
67  Field& operator=(Field&&) noexcept = default;
68  ~Field() noexcept = default;
69 
71  std::string const& getName() const noexcept { return _name; }
72 
74  std::string const& getDoc() const noexcept { return _doc; }
75 
77  std::string const& getUnits() const noexcept { return _units; }
78 
80  inline friend std::ostream& operator<<(std::ostream& os, Field<T> const& field) {
81  os << "Field['" << Field<T>::getTypeString() << "'](name=\"" << field.getName() << "\"";
82  if (!field.getDoc().empty()) os << ", doc=\"" << field.getDoc() << "\"";
83  if (!field.getUnits().empty()) os << ", units=\"" << field.getUnits() << "\"";
84  field.stream(os);
85  return os << ")";
86  }
87 
89  Field<T> copyRenamed(std::string const& newName) const {
90  return Field<T>(newName, getDoc(), getUnits(), *this);
91  }
92 
93 private:
94  std::string _name;
95  std::string _doc;
96  std::string _units;
97 };
98 } // namespace table
99 } // namespace afw
100 } // namespace lsst
101 
102 #endif // !AFW_TABLE_Field_h_INCLUDED
table::Key< std::string > name
Definition: Amplifier.cc:116
table::Key< int > field
Definition: ApCorrMap.cc:77
std::ostream * os
Definition: Schema.cc:557
A base class for image defects.
STL namespace.
Field base class default implementation (used for numeric scalars and lsst::geom::Angle).
Definition: FieldBase.h:41
static std::string getTypeString()
Return a string description of the field type.
Definition: FieldBase.cc:56
T Element
the type of subfields (the same as the type itself for scalars)
Definition: FieldBase.h:45
A description of a field in a table.
Definition: Field.h:24
Field< T > copyRenamed(std::string const &newName) const
Return a new Field with a new name and other properties the same as this.
Definition: Field.h:89
typename FieldBase< T >::Element Element
Type used to store field data in the table (a field may have multiple elements).
Definition: Field.h:26
std::string const & getUnits() const noexcept
Return the units for the field.
Definition: Field.h:77
Field(std::string const &name, std::string const &doc, FieldBase< T > const &size)
Construct a new field.
Definition: Field.h:61
Field(std::string const &name, std::string const &doc, std::string const &units="", FieldBase< T > const &size=FieldBase< T >())
Construct a new field.
Definition: Field.h:44
std::string const & getName() const noexcept
Return the name of the field.
Definition: Field.h:71
Field(Field const &)=default
Field(Field &&) noexcept=default
std::string const & getDoc() const noexcept
Return the documentation for the field.
Definition: Field.h:74
friend std::ostream & operator<<(std::ostream &os, Field< T > const &field)
Stringification.
Definition: Field.h:80