Skip to main content

vortex_array/arrays/bool/compute/
fill_null.rs

1// SPDX-License-Identifier: Apache-2.0
2// SPDX-FileCopyrightText: Copyright the Vortex contributors
3
4use vortex_error::VortexResult;
5use vortex_error::vortex_err;
6
7use crate::ArrayRef;
8use crate::ExecutionCtx;
9use crate::IntoArray;
10use crate::array::ArrayView;
11use crate::arrays::Bool;
12use crate::arrays::BoolArray;
13use crate::arrays::bool::BoolArrayExt;
14use crate::scalar::Scalar;
15use crate::scalar_fn::fns::fill_null::FillNullKernel;
16use crate::validity::Validity;
17
18impl FillNullKernel for Bool {
19    fn fill_null(
20        array: ArrayView<'_, Bool>,
21        fill_value: &Scalar,
22        ctx: &mut ExecutionCtx,
23    ) -> VortexResult<Option<ArrayRef>> {
24        let fill = fill_value
25            .as_bool()
26            .value()
27            .ok_or_else(|| vortex_err!("Fill value must be non null"))?;
28
29        Ok(Some(match array.validity()? {
30            Validity::Array(v) => {
31                let v_bool = v.execute::<BoolArray>(ctx)?;
32                let bool_buffer = if fill {
33                    array.to_bit_buffer() | &!v_bool.to_bit_buffer()
34                } else {
35                    array.to_bit_buffer() & v_bool.to_bit_buffer()
36                };
37                BoolArray::new(bool_buffer, fill_value.dtype().nullability().into()).into_array()
38            }
39            _ => unreachable!("checked in entry point"),
40        }))
41    }
42}
43
44#[cfg(test)]
45mod tests {
46    use std::sync::LazyLock;
47
48    use rstest::rstest;
49    use vortex_buffer::BitBuffer;
50    use vortex_buffer::bitbuffer;
51    use vortex_session::VortexSession;
52
53    use crate::IntoArray;
54    use crate::VortexSessionExecute;
55    use crate::arrays::BoolArray;
56    use crate::arrays::bool::BoolArrayExt;
57    use crate::builtins::ArrayBuiltins;
58    use crate::dtype::DType;
59    use crate::dtype::Nullability;
60    use crate::scalar::Scalar;
61    use crate::validity::Validity;
62
63    static SESSION: LazyLock<VortexSession> = LazyLock::new(VortexSession::empty);
64
65    #[rstest]
66    #[case(true, bitbuffer![true, true, false, true])]
67    #[case(false, bitbuffer![true, false, false, false])]
68    fn bool_fill_null(#[case] fill_value: bool, #[case] expected: BitBuffer) {
69        let mut ctx = SESSION.create_execution_ctx();
70        let bool_array = BoolArray::new(
71            BitBuffer::from_iter([true, true, false, false]),
72            Validity::from_iter([true, false, true, false]),
73        );
74        let non_null_array = bool_array
75            .into_array()
76            .fill_null(Scalar::from(fill_value))
77            .unwrap()
78            .execute::<BoolArray>(&mut ctx)
79            .unwrap();
80        assert_eq!(non_null_array.to_bit_buffer(), expected);
81        assert_eq!(
82            non_null_array.dtype(),
83            &DType::Bool(Nullability::NonNullable)
84        );
85    }
86}