Function take

arrow-select/src/take.rs:88–104

Take elements by index from [Array], creating a new [Array] from those indexes. ```text ┌─────────────────┐ ┌─────────┐ ┌─────────────────┐ │ A │ │ 0 │ │ A │ ├─────────────────┤ ├─────────┤ ├─────────────────┤ │ D │ │ 2 │

(
    values: &dyn Array,
    indices: &dyn Array,
    options: Option<TakeOptions>,
)

/// assert_eq!(*taken, StringArray::from(vec!["two", "one"]));
/// ```
pub fn take(
    values: &dyn Array,
    indices: &dyn Array,
    options: Option<TakeOptions>,
) -> Result<ArrayRef, ArrowError> {
    let options = options.unwrap_or_default();
    downcast_integer_array!(
        indices => {
            if options.check_bounds {
                check_bounds(values.len(), indices)?;
            }
            let indices = indices.to_indices();
            take_impl(values, &indices)
        },
        d => Err(ArrowError::InvalidArgumentError(format!("Take only supported for integers, got {d:?}")))
    )
}

/// For each [ArrayRef] in the [`Vec<ArrayRef>`], take elements by index and create a new
/// [`Vec<ArrayRef>`] from those indices.