Method try_push_array

src/repr/src/row.rs:2443–2463

Convenience function to construct an array from an iter of `Datum`s. Returns an error if the number of elements in `iter` does not match the cardinality of the array as described by `dims`, or if the number of dimensions exceeds [`MAX_ARRAY_DIMENSIONS`]. If an error occurs, the packer's state will be unchanged.

(
        &mut self,
        dims: &[ArrayDimension],
        iter: I,
    )

    /// number of dimensions exceeds [`MAX_ARRAY_DIMENSIONS`]. If an error
    /// occurs, the packer's state will be unchanged.
    pub fn try_push_array<'a, I, D>(
        &mut self,
        dims: &[ArrayDimension],
        iter: I,
    ) -> Result<(), InvalidArrayError>
    where
        I: IntoIterator<Item = D>,
        D: Borrow<Datum<'a>>,
    {
        // SAFETY: The function returns the exact number of elements pushed into the array.
        unsafe {
            self.push_array_with_unchecked(dims, |packer| {
                let mut nelements = 0;
                for datum in iter {
                    packer.push(datum);
                    nelements += 1;
                }
                Ok::<_, InvalidArrayError>(nelements)
            })
        }
    }

    /// Like [`RowPacker::try_push_array`], but accepts a fallible iterator of
    /// elements.