Method try_new

arrow-array/src/array/dictionary_array.rs:289–317

Attempt to create a new DictionaryArray with a specified keys (indexes into the dictionary) and values (dictionary) array. # Errors Returns an error if any `keys[i] >= values.len() || keys[i] < 0`

(keys: PrimitiveArray<K>, values: ArrayRef)

    ///
    /// Returns an error if any `keys[i] >= values.len() || keys[i] < 0`
    pub fn try_new(keys: PrimitiveArray<K>, values: ArrayRef) -> Result<Self, ArrowError> {
        let data_type = DataType::Dictionary(
            Box::new(keys.data_type().clone()),
            Box::new(values.data_type().clone()),
        );

        // // we can skip the validating the keys if they are all null
        let all_null = keys.null_count() == keys.len();

        if !all_null {
            let zero = K::Native::usize_as(0);
            let values_len = values.len();

            if let Some((idx, v)) = keys.values().iter().enumerate().find(|(idx, v)| {
                (v.is_lt(zero) || v.as_usize() >= values_len) && keys.is_valid(*idx)
            }) {
                return Err(ArrowError::InvalidArgumentError(format!(
                    "Invalid dictionary key {v:?} at index {idx}, expected 0 <= key < {values_len}",
                )));
            }
        }

        Ok(Self {
            data_type,
            keys,
            values,
            is_ordered: false,
        })
    }

    /// Create a new [`Scalar`] from `value`
    pub fn new_scalar<T: Array + 'static>(value: Scalar<T>) -> Scalar<Self> {