Function concat_elements_binary_view_array

arrow-string/src/concat_elements.rs:230–260

Concatenates two `BinaryViewArray`s element-wise. If either element is `Null`, the result element is also `Null`. # Errors - Returns an error if the input arrays have different lengths. - Returns an error if any concatenated value exceeds `u32::MAX` in length.

(
    left: &BinaryViewArray,
    right: &BinaryViewArray,
)

/// - Returns an error if the input arrays have different lengths.
/// - Returns an error if any concatenated value exceeds `u32::MAX` in length.
pub fn concat_elements_binary_view_array(
    left: &BinaryViewArray,
    right: &BinaryViewArray,
) -> Result<BinaryViewArray, ArrowError> {
    if left.len() != right.len() {
        return Err(ArrowError::ComputeError(format!(
            "Arrays must have the same length: {} != {}",
            left.len(),
            right.len()
        )));
    }
    let mut result = BinaryViewBuilder::with_capacity(left.len());

    // Avoid reallocations by writing to a reused buffer
    let mut buffer = MutableBuffer::new(0);

    // Pre-compute combined null bitmap, so the per-row NULL check is efficient
    let nulls = NullBuffer::union(left.nulls(), right.nulls());

    for i in 0..left.len() {
        if nulls.as_ref().is_some_and(|n| n.is_null(i)) {
            result.append_null();
        } else {
            buffer.clear();
            buffer.extend_from_slice(left.value(i));
            buffer.extend_from_slice(right.value(i));
            result.try_append_value(&buffer)?;
        }
    }
    Ok(result.finish())
}

/// Concatenates two `StringViewArray`s element-wise.
/// If either element is `Null`, the result element is also `Null`.