use std::sync::Arc;
use polars_error::{polars_bail, PolarsResult};
use super::{BinaryArray, MutableBinaryArray};
use crate::array::physical_binary::*;
use crate::array::specification::try_check_offsets_bounds;
use crate::array::{
Array, ArrayAccessor, ArrayValuesIter, MutableArray, TryExtend, TryExtendFromSelf, TryPush,
};
use crate::bitmap::MutableBitmap;
use crate::datatypes::ArrowDataType;
use crate::offset::{Offset, Offsets};
use crate::trusted_len::TrustedLen;
#[derive(Debug, Clone)]
pub struct MutableBinaryValuesArray<O: Offset> {
data_type: ArrowDataType,
offsets: Offsets<O>,
values: Vec<u8>,
}
impl<O: Offset> From<MutableBinaryValuesArray<O>> for BinaryArray<O> {
fn from(other: MutableBinaryValuesArray<O>) -> Self {
BinaryArray::<O>::new(
other.data_type,
other.offsets.into(),
other.values.into(),
None,
)
}
}
impl<O: Offset> From<MutableBinaryValuesArray<O>> for MutableBinaryArray<O> {
fn from(other: MutableBinaryValuesArray<O>) -> Self {
MutableBinaryArray::<O>::try_new(other.data_type, other.offsets, other.values, None)
.expect("MutableBinaryValuesArray is consistent with MutableBinaryArray")
}
}
impl<O: Offset> Default for MutableBinaryValuesArray<O> {
fn default() -> Self {
Self::new()
}
}
impl<O: Offset> MutableBinaryValuesArray<O> {
pub fn new() -> Self {
Self {
data_type: Self::default_data_type(),
offsets: Offsets::new(),
values: Vec::<u8>::new(),
}
}
pub fn try_new(
data_type: ArrowDataType,
offsets: Offsets<O>,
values: Vec<u8>,
) -> PolarsResult<Self> {
try_check_offsets_bounds(&offsets, values.len())?;
if data_type.to_physical_type() != Self::default_data_type().to_physical_type() {
polars_bail!(ComputeError: "MutableBinaryValuesArray can only be initialized with DataType::Binary or DataType::LargeBinary",)
}
Ok(Self {
data_type,
offsets,
values,
})
}
pub fn default_data_type() -> ArrowDataType {
BinaryArray::<O>::default_data_type()
}
pub fn with_capacity(capacity: usize) -> Self {
Self::with_capacities(capacity, 0)
}
pub fn with_capacities(capacity: usize, values: usize) -> Self {
Self {
data_type: Self::default_data_type(),
offsets: Offsets::<O>::with_capacity(capacity),
values: Vec::<u8>::with_capacity(values),
}
}
#[inline]
pub fn values(&self) -> &Vec<u8> {
&self.values
}
#[inline]
pub fn offsets(&self) -> &Offsets<O> {
&self.offsets
}
#[inline]
pub fn reserve(&mut self, additional: usize, additional_values: usize) {
self.offsets.reserve(additional);
self.values.reserve(additional_values);
}
pub fn capacity(&self) -> usize {
self.offsets.capacity()
}
#[inline]
pub fn len(&self) -> usize {
self.offsets.len_proxy()
}
#[inline]
pub fn push<T: AsRef<[u8]>>(&mut self, value: T) {
self.try_push(value).unwrap()
}
pub fn pop(&mut self) -> Option<Vec<u8>> {
if self.len() == 0 {
return None;
}
self.offsets.pop()?;
let start = self.offsets.last().to_usize();
let value = self.values.split_off(start);
Some(value.to_vec())
}
#[inline]
pub fn value(&self, i: usize) -> &[u8] {
assert!(i < self.len());
unsafe { self.value_unchecked(i) }
}
#[inline]
pub unsafe fn value_unchecked(&self, i: usize) -> &[u8] {
let (start, end) = self.offsets.start_end(i);
self.values.get_unchecked(start..end)
}
pub fn iter(&self) -> ArrayValuesIter<Self> {
ArrayValuesIter::new(self)
}
pub fn shrink_to_fit(&mut self) {
self.values.shrink_to_fit();
self.offsets.shrink_to_fit();
}
pub fn into_inner(self) -> (ArrowDataType, Offsets<O>, Vec<u8>) {
(self.data_type, self.offsets, self.values)
}
}
impl<O: Offset> MutableArray for MutableBinaryValuesArray<O> {
fn len(&self) -> usize {
self.len()
}
fn validity(&self) -> Option<&MutableBitmap> {
None
}
fn as_box(&mut self) -> Box<dyn Array> {
let (data_type, offsets, values) = std::mem::take(self).into_inner();
BinaryArray::new(data_type, offsets.into(), values.into(), None).boxed()
}
fn as_arc(&mut self) -> Arc<dyn Array> {
let (data_type, offsets, values) = std::mem::take(self).into_inner();
BinaryArray::new(data_type, offsets.into(), values.into(), None).arced()
}
fn data_type(&self) -> &ArrowDataType {
&self.data_type
}
fn as_any(&self) -> &dyn std::any::Any {
self
}
fn as_mut_any(&mut self) -> &mut dyn std::any::Any {
self
}
#[inline]
fn push_null(&mut self) {
self.push::<&[u8]>(b"")
}
fn reserve(&mut self, additional: usize) {
self.reserve(additional, 0)
}
fn shrink_to_fit(&mut self) {
self.shrink_to_fit()
}
}
impl<O: Offset, P: AsRef<[u8]>> FromIterator<P> for MutableBinaryValuesArray<O> {
fn from_iter<I: IntoIterator<Item = P>>(iter: I) -> Self {
let (offsets, values) = values_iter(iter.into_iter());
Self::try_new(Self::default_data_type(), offsets, values).unwrap()
}
}
impl<O: Offset> MutableBinaryValuesArray<O> {
pub(crate) unsafe fn extend_from_trusted_len_iter<I, P>(
&mut self,
validity: &mut MutableBitmap,
iterator: I,
) where
P: AsRef<[u8]>,
I: Iterator<Item = Option<P>>,
{
extend_from_trusted_len_iter(&mut self.offsets, &mut self.values, validity, iterator);
}
#[inline]
pub fn extend_trusted_len<I, P>(&mut self, iterator: I)
where
P: AsRef<[u8]>,
I: TrustedLen<Item = P>,
{
unsafe { self.extend_trusted_len_unchecked(iterator) }
}
#[inline]
pub unsafe fn extend_trusted_len_unchecked<I, P>(&mut self, iterator: I)
where
P: AsRef<[u8]>,
I: Iterator<Item = P>,
{
extend_from_trusted_len_values_iter(&mut self.offsets, &mut self.values, iterator);
}
#[inline]
pub fn from_trusted_len_iter<I, P>(iterator: I) -> Self
where
P: AsRef<[u8]>,
I: TrustedLen<Item = P>,
{
unsafe { Self::from_trusted_len_iter_unchecked(iterator) }
}
#[inline]
pub unsafe fn from_trusted_len_iter_unchecked<I, P>(iterator: I) -> Self
where
P: AsRef<[u8]>,
I: Iterator<Item = P>,
{
let (offsets, values) = trusted_len_values_iter(iterator);
Self::try_new(Self::default_data_type(), offsets, values).unwrap()
}
pub fn try_from_iter<P: AsRef<[u8]>, I: IntoIterator<Item = P>>(iter: I) -> PolarsResult<Self> {
let iterator = iter.into_iter();
let (lower, _) = iterator.size_hint();
let mut array = Self::with_capacity(lower);
for item in iterator {
array.try_push(item)?;
}
Ok(array)
}
pub fn extend_fallible<T, I, E>(&mut self, iter: I) -> std::result::Result<(), E>
where
E: std::error::Error,
I: IntoIterator<Item = std::result::Result<T, E>>,
T: AsRef<[u8]>,
{
let mut iter = iter.into_iter();
self.reserve(iter.size_hint().0, 0);
iter.try_for_each(|x| {
self.push(x?);
Ok(())
})
}
}
impl<O: Offset, T: AsRef<[u8]>> Extend<T> for MutableBinaryValuesArray<O> {
fn extend<I: IntoIterator<Item = T>>(&mut self, iter: I) {
extend_from_values_iter(&mut self.offsets, &mut self.values, iter.into_iter());
}
}
impl<O: Offset, T: AsRef<[u8]>> TryExtend<T> for MutableBinaryValuesArray<O> {
fn try_extend<I: IntoIterator<Item = T>>(&mut self, iter: I) -> PolarsResult<()> {
let mut iter = iter.into_iter();
self.reserve(iter.size_hint().0, 0);
iter.try_for_each(|x| self.try_push(x))
}
}
impl<O: Offset, T: AsRef<[u8]>> TryPush<T> for MutableBinaryValuesArray<O> {
#[inline]
fn try_push(&mut self, value: T) -> PolarsResult<()> {
let bytes = value.as_ref();
self.values.extend_from_slice(bytes);
self.offsets.try_push(bytes.len())
}
}
unsafe impl<'a, O: Offset> ArrayAccessor<'a> for MutableBinaryValuesArray<O> {
type Item = &'a [u8];
#[inline]
unsafe fn value_unchecked(&'a self, index: usize) -> Self::Item {
self.value_unchecked(index)
}
#[inline]
fn len(&self) -> usize {
self.len()
}
}
impl<O: Offset> TryExtendFromSelf for MutableBinaryValuesArray<O> {
fn try_extend_from_self(&mut self, other: &Self) -> PolarsResult<()> {
self.values.extend_from_slice(&other.values);
self.offsets.try_extend_from_self(&other.offsets)
}
}