Method compact

datafusion/common/src/scalar/mod.rs:4721–4799

Compacts the allocation referenced by `self` to the minimum, copying the data if necessary. This can be relevant when `self` is a list or contains a list as a nested value, as a single list holds an Arc to its entire original array buffer.

(&mut self)

    /// This can be relevant when `self` is a list or contains a list as a nested value, as
    /// a single list holds an Arc to its entire original array buffer.
    pub fn compact(&mut self) {
        // copy_array_data + compact_view_buffers + downcast back, all in one step.
        macro_rules! compact_array {
            ($arr:expr, $from_type:ty, $($as_method:tt)+) => {
                *Arc::make_mut($arr) = ScalarValue::compact_view_buffers(
                    Arc::new(<$from_type>::from(copy_array_data(&$arr.to_data()))) as ArrayRef,
                ).$($as_method)+.clone()
            };
        }
        match self {
            ScalarValue::Null
            | ScalarValue::Boolean(_)
            | ScalarValue::Float16(_)
            | ScalarValue::Float32(_)
            | ScalarValue::Float64(_)
            | ScalarValue::Decimal32(_, _, _)
            | ScalarValue::Decimal64(_, _, _)
            | ScalarValue::Decimal128(_, _, _)
            | ScalarValue::Decimal256(_, _, _)
            | ScalarValue::Int8(_)
            | ScalarValue::Int16(_)
            | ScalarValue::Int32(_)
            | ScalarValue::Int64(_)
            | ScalarValue::UInt8(_)
            | ScalarValue::UInt16(_)
            | ScalarValue::UInt32(_)
            | ScalarValue::UInt64(_)
            | ScalarValue::Date32(_)
            | ScalarValue::Date64(_)
            | ScalarValue::Time32Second(_)
            | ScalarValue::Time32Millisecond(_)
            | ScalarValue::Time64Microsecond(_)
            | ScalarValue::Time64Nanosecond(_)
            | ScalarValue::IntervalYearMonth(_)
            | ScalarValue::IntervalDayTime(_)
            | ScalarValue::IntervalMonthDayNano(_)
            | ScalarValue::DurationSecond(_)
            | ScalarValue::DurationMillisecond(_)
            | ScalarValue::DurationMicrosecond(_)
            | ScalarValue::DurationNanosecond(_)
            | ScalarValue::Utf8(_)
            | ScalarValue::LargeUtf8(_)
            | ScalarValue::Utf8View(_)
            | ScalarValue::TimestampSecond(_, _)
            | ScalarValue::TimestampMillisecond(_, _)
            | ScalarValue::TimestampMicrosecond(_, _)
            | ScalarValue::TimestampNanosecond(_, _)
            | ScalarValue::Binary(_)
            | ScalarValue::FixedSizeBinary(_, _)
            | ScalarValue::LargeBinary(_)
            | ScalarValue::BinaryView(_) => (),
            ScalarValue::FixedSizeList(arr) => {
                compact_array!(arr, FixedSizeListArray, as_fixed_size_list())
            }
            ScalarValue::List(arr) => compact_array!(arr, ListArray, as_list::<i32>()),
            ScalarValue::LargeList(arr) => {
                compact_array!(arr, LargeListArray, as_list::<i64>())
            }