|
| ArrayGenerator (const FormPtr &form, int64_t length) |
| Called by subclasses to set the form of an ArrayGenerator.
|
|
virtual | ~ArrayGenerator () |
| Virtual destructor acts as a first non-inline virtual function that determines a specific translation unit in which vtable shall be emitted.
|
|
const FormPtr | form () const |
| The Form the generated array is expected to take; may be nullptr .
|
|
int64_t | length () const |
| The length the generated array is expected to have; may be negative to indicate that the length is unknown.
|
|
virtual const ContentPtr | generate () const =0 |
| Creates an array but does not check it against the form.
|
|
const ContentPtr | generate_and_check () |
| Creates an array and checks it against the form. If form was not available initially, no check is made and the form inferred from the result is saved in case it is useful later.
|
|
virtual void | caches (std::vector< ArrayCachePtr > &out) const =0 |
| Accumulates all the unique #ArrayCache objects from nested #VirtualArray nodes. (Uniqueness is determined by pointer value.)
|
|
virtual const std::string | tostring_part (const std::string &indent, const std::string &pre, const std::string &post) const =0 |
| Returns a string representation of this ArrayGenerator.
|
|
virtual const std::shared_ptr< ArrayGenerator > | shallow_copy () const =0 |
| Copies this ArrayGenerator, referencing any contents.
|
|
virtual const std::shared_ptr< ArrayGenerator > | with_form (const FormPtr &form) const =0 |
| Return a copy of this ArrayGenerator with a different form (or a now-known form, whereas it might have been unknown before).
|
|
virtual const std::shared_ptr< ArrayGenerator > | with_length (int64_t length) const =0 |
| Return a copy of this ArrayGenerator with a different length (or a now-known length, whereas it might have been unknown before).
|
|
virtual bool | referentially_equal (const ArrayGeneratorPtr &other) const =0 |
| Returns true if this generator has all the same buffers and parameters as other ; false otherwise.
|
|
Abstract superclass to generate arrays for VirtualArray, defining the interface.
The main implementation, PyArrayGenerator, is passed through pybind11 to Python to work with Python functions and lambdas, but in principle, pure C++ generators could be written.
Called by subclasses to set the form of an ArrayGenerator.
The form can be nullptr
, in which case the generated array can have any Form and any Type, but doing so would cause VirtualArray to materialize in more circumstances, undermining its usefulness.
Similarly, the length can be specified to avoid materializing a VirtualArray when its length must be known. Any negative value, such as -1, is interpreted as "unknown."