LSST Applications
21.0.0-172-gfb10e10a+18fedfabac,22.0.0+297cba6710,22.0.0+80564b0ff1,22.0.0+8d77f4f51a,22.0.0+a28f4c53b1,22.0.0+dcf3732eb2,22.0.1-1-g7d6de66+2a20fdde0d,22.0.1-1-g8e32f31+297cba6710,22.0.1-1-geca5380+7fa3b7d9b6,22.0.1-12-g44dc1dc+2a20fdde0d,22.0.1-15-g6a90155+515f58c32b,22.0.1-16-g9282f48+790f5f2caa,22.0.1-2-g92698f7+dcf3732eb2,22.0.1-2-ga9b0f51+7fa3b7d9b6,22.0.1-2-gd1925c9+bf4f0e694f,22.0.1-24-g1ad7a390+a9625a72a8,22.0.1-25-g5bf6245+3ad8ecd50b,22.0.1-25-gb120d7b+8b5510f75f,22.0.1-27-g97737f7+2a20fdde0d,22.0.1-32-gf62ce7b1+aa4237961e,22.0.1-4-g0b3f228+2a20fdde0d,22.0.1-4-g243d05b+871c1b8305,22.0.1-4-g3a563be+32dcf1063f,22.0.1-4-g44f2e3d+9e4ab0f4fa,22.0.1-42-gca6935d93+ba5e5ca3eb,22.0.1-5-g15c806e+85460ae5f3,22.0.1-5-g58711c4+611d128589,22.0.1-5-g75bb458+99c117b92f,22.0.1-6-g1c63a23+7fa3b7d9b6,22.0.1-6-g50866e6+84ff5a128b,22.0.1-6-g8d3140d+720564cf76,22.0.1-6-gd805d02+cc5644f571,22.0.1-8-ge5750ce+85460ae5f3,master-g6e05de7fdc+babf819c66,master-g99da0e417a+8d77f4f51a,w.2021.48
LSST Data Management Base Package
|
Field base class specialization for arrays. More...
#include <FieldBase.h>
Public Types | |
using | Value = ndarray::Array< const U, 1, 1 > |
the type returned by BaseRecord::get More... | |
using | Reference = ndarray::ArrayRef< U, 1, 1 > |
the type returned by BaseRecord::operator[] More... | |
using | ConstReference = ndarray::ArrayRef< const U, 1, 1 > |
the type returned by BaseRecord::operator[] (const) More... | |
using | Element = U |
the type of subfields and array elements More... | |
Public Member Functions | |
FieldBase (size_t size=0) | |
Construct a FieldBase with the given size. More... | |
FieldBase (FieldBase const &) noexcept=default | |
FieldBase (FieldBase &&) noexcept=default | |
FieldBase & | operator= (FieldBase const &) noexcept=default |
FieldBase & | operator= (FieldBase &&) noexcept=default |
~FieldBase () noexcept=default | |
std::size_t | getElementCount () const noexcept |
Return the number of subfield elements (equal to the size of the array), or 0 for a variable-length array. More... | |
std::size_t | getSize () const noexcept |
Return the size of the array (equal to the number of subfield elements), or 0 for a variable-length array. More... | |
bool | isVariableLength () const noexcept |
Return true if the field is variable-length (each record can have a different size array). More... | |
Static Public Member Functions | |
static std::string | getTypeString () |
Return a string description of the field type. More... | |
Protected Member Functions | |
void | stream (std::ostream &os) const |
Defines how Fields are printed. More... | |
Reference | getReference (Element *p, ndarray::Manager::Ptr const &m) const |
Used to implement BaseRecord::operator[] (non-const). More... | |
ConstReference | getConstReference (Element const *p, ndarray::Manager::Ptr const &m) const |
Used to implement BaseRecord::operator[] (const). More... | |
Value | getValue (Element const *p, ndarray::Manager::Ptr const &m) const |
Used to implement BaseRecord::get. More... | |
void | setValue (Element *p, ndarray::Manager::Ptr const &, ndarray::Array< Element, 1, 1 > const &value) const |
Used to implement BaseRecord::set; accepts only non-const arrays of the right type. More... | |
template<typename Derived > | |
void | setValue (Element *p, ndarray::Manager::Ptr const &, ndarray::ExpressionBase< Derived > const &value) const |
Used to implement BaseRecord::set; accepts any ndarray expression. More... | |
Static Protected Member Functions | |
static FieldBase | makeDefault () noexcept |
Needed to allow Keys to be default-constructed. More... | |
Field base class specialization for arrays.
The Array tag is used for both fixed-length (same size in every record, accessible via ColumnView) and variable-length arrays; variable-length arrays are initialized with a size of 0. Ideally, we'd use complete different tag classes for those two very different types, but this was limited in the original (pre-C++11) implementation and now it would be an API change.
Definition at line 96 of file FieldBase.h.
using lsst::afw::table::FieldBase< Array< U > >::ConstReference = ndarray::ArrayRef<const U, 1, 1> |
the type returned by BaseRecord::operator[] (const)
Definition at line 103 of file FieldBase.h.
using lsst::afw::table::FieldBase< Array< U > >::Element = U |
the type of subfields and array elements
Definition at line 105 of file FieldBase.h.
using lsst::afw::table::FieldBase< Array< U > >::Reference = ndarray::ArrayRef<U, 1, 1> |
the type returned by BaseRecord::operator[]
Definition at line 100 of file FieldBase.h.
using lsst::afw::table::FieldBase< Array< U > >::Value = ndarray::Array<const U, 1, 1> |
the type returned by BaseRecord::get
Definition at line 97 of file FieldBase.h.
|
inline |
Construct a FieldBase with the given size.
A size == 0 indicates a variable-length array. Negative sizes are not permitted.
This constructor is implicit with a default so it can be used in the Field constructor (as if it were an int argument) without specializing Field. In other words, it allows one to construct a 25-element array field like this:
Field< Array<float> >("name", "documentation", 25);
...even though the third argument to the Field constructor takes a FieldBase, not an int.
Definition at line 120 of file FieldBase.h.
|
defaultnoexcept |
|
defaultnoexcept |
|
defaultnoexcept |
|
inlineprotected |
Used to implement BaseRecord::operator[] (const).
Definition at line 159 of file FieldBase.h.
|
inlinenoexcept |
Return the number of subfield elements (equal to the size of the array), or 0 for a variable-length array.
Definition at line 134 of file FieldBase.h.
|
inlineprotected |
|
inlinenoexcept |
Return the size of the array (equal to the number of subfield elements), or 0 for a variable-length array.
Definition at line 138 of file FieldBase.h.
|
static |
Return a string description of the field type.
Definition at line 63 of file FieldBase.cc.
|
inlineprotected |
|
inlinenoexcept |
Return true if the field is variable-length (each record can have a different size array).
Definition at line 141 of file FieldBase.h.
|
inlinestaticprotectednoexcept |
Needed to allow Keys to be default-constructed.
Definition at line 145 of file FieldBase.h.
|
defaultnoexcept |
|
defaultnoexcept |
|
inlineprotected |
Used to implement BaseRecord::set; accepts only non-const arrays of the right type.
Fixed-length arrays are handled by copying the data from value
to p
through p + _size
. Variable-length arrays are handled by setting p
to the address of value
, an ndarray, hence a shallow copy (ndarray arrays are reference-counted so this will not leak memory). If you want deep assignment of variable-length data, use operator[] to get a reference and assign to that.
Definition at line 180 of file FieldBase.h.
|
inlineprotected |
Used to implement BaseRecord::set; accepts any ndarray expression.
Definition at line 191 of file FieldBase.h.
|
inlineprotected |