Method append_array

arrow-array/src/builder/generic_bytes_view_builder.rs:223–250

Appends an array to the builder. This will flush any in-progress block and append the data buffers and add the (adapted) views.

(&mut self, array: &GenericByteViewArray<T>)

    /// This will flush any in-progress block and append the data buffers
    /// and add the (adapted) views.
    pub fn append_array(&mut self, array: &GenericByteViewArray<T>) {
        self.flush_in_progress();
        // keep original views if this array is the first to be added or if there are no data buffers (all inline views)
        let keep_views = self.completed.is_empty() || array.data_buffers().is_empty();
        let starting_buffer = self.completed.len() as u32;

        self.completed.extend(array.data_buffers().iter().cloned());

        if keep_views {
            self.views_buffer.extend_from_slice(array.views());
        } else {
            self.views_buffer.extend(array.views().iter().map(|v| {
                let mut byte_view = ByteView::from(*v);
                if byte_view.length > MAX_INLINE_VIEW_LEN {
                    // Small views (<=12 bytes) are inlined, so only need to update large views
                    byte_view.buffer_index += starting_buffer;
                };

                byte_view.as_u128()
            }));
        }

        if let Some(null_buffer) = array.nulls() {
            self.null_buffer_builder.append_buffer(null_buffer);
        } else {
            self.null_buffer_builder.append_n_non_nulls(array.len());
        }
    }

    /// Try to append a view of the given `block`, `offset` and `length`
    ///