Struct rerun::external::re_entity_db::external::re_data_store::external::arrow2::array::MutableUtf8Array
source · pub struct MutableUtf8Array<O>where
O: Offset,{ /* private fields */ }
Expand description
A MutableArray
that builds a Utf8Array
. It differs
from MutableUtf8ValuesArray
in that it can build nullable Utf8Array
s.
Implementations§
source§impl<O> MutableUtf8Array<O>where
O: Offset,
impl<O> MutableUtf8Array<O>where
O: Offset,
sourcepub fn new() -> MutableUtf8Array<O>
pub fn new() -> MutableUtf8Array<O>
Initializes a new empty MutableUtf8Array
.
sourcepub fn try_new(
data_type: DataType,
offsets: Offsets<O>,
values: Vec<u8>,
validity: Option<MutableBitmap>
) -> Result<MutableUtf8Array<O>, Error>
pub fn try_new( data_type: DataType, offsets: Offsets<O>, values: Vec<u8>, validity: Option<MutableBitmap> ) -> Result<MutableUtf8Array<O>, Error>
Returns a MutableUtf8Array
created from its internal representation.
§Errors
This function returns an error iff:
- The last offset is not equal to the values’ length.
- the validity’s length is not equal to
offsets.len()
. - The
data_type
’scrate::datatypes::PhysicalType
is not equal to eitherUtf8
orLargeUtf8
. - The
values
between two consecutiveoffsets
are not valid utf8
§Implementation
This function is O(N)
- checking utf8 is O(N)
sourcepub unsafe fn new_unchecked(
data_type: DataType,
offsets: Offsets<O>,
values: Vec<u8>,
validity: Option<MutableBitmap>
) -> MutableUtf8Array<O>
pub unsafe fn new_unchecked( data_type: DataType, offsets: Offsets<O>, values: Vec<u8>, validity: Option<MutableBitmap> ) -> MutableUtf8Array<O>
Create a MutableUtf8Array
out of low-end APIs.
§Safety
The caller must ensure that every value between offsets is a valid utf8.
§Panics
This function panics iff:
- The
offsets
andvalues
are inconsistent - The validity is not
None
and its length is different fromoffsets
’s length minus one.
sourcepub fn from<T, P>(slice: P) -> MutableUtf8Array<O>
pub fn from<T, P>(slice: P) -> MutableUtf8Array<O>
Creates a new MutableUtf8Array
from a slice of optional &[u8]
.
sourcepub fn with_capacity(capacity: usize) -> MutableUtf8Array<O>
pub fn with_capacity(capacity: usize) -> MutableUtf8Array<O>
Initializes a new MutableUtf8Array
with a pre-allocated capacity of slots.
sourcepub fn with_capacities(capacity: usize, values: usize) -> MutableUtf8Array<O>
pub fn with_capacities(capacity: usize, values: usize) -> MutableUtf8Array<O>
Initializes a new MutableUtf8Array
with a pre-allocated capacity of slots and values.
sourcepub fn reserve(&mut self, additional: usize, additional_values: usize)
pub fn reserve(&mut self, additional: usize, additional_values: usize)
Reserves additional
elements and additional_values
on the values buffer.
sourcepub fn capacity(&self) -> usize
pub fn capacity(&self) -> usize
Reserves additional
elements and additional_values
on the values buffer.
sourcepub fn push<T>(&mut self, value: Option<T>)
pub fn push<T>(&mut self, value: Option<T>)
Pushes a new element to the array.
§Panic
This operation panics iff the length of all values (in bytes) exceeds O
maximum value.
sourcepub fn value(&self, i: usize) -> &str
pub fn value(&self, i: usize) -> &str
Returns the value of the element at index i
, ignoring the array’s validity.
§Safety
This function is safe iff i < self.len
.
sourcepub unsafe fn value_unchecked(&self, i: usize) -> &str
pub unsafe fn value_unchecked(&self, i: usize) -> &str
Returns the value of the element at index i
, ignoring the array’s validity.
§Safety
This function is safe iff i < self.len
.
sourcepub fn pop(&mut self) -> Option<String>
pub fn pop(&mut self) -> Option<String>
Pop the last entry from MutableUtf8Array
.
This function returns None
iff this array is empty.
sourcepub fn iter(
&self
) -> ZipValidity<&str, ArrayValuesIter<'_, MutableUtf8ValuesArray<O>>, BitmapIter<'_>> ⓘ
pub fn iter( &self ) -> ZipValidity<&str, ArrayValuesIter<'_, MutableUtf8ValuesArray<O>>, BitmapIter<'_>> ⓘ
Returns an iterator of Option<&str>
sourcepub fn shrink_to_fit(&mut self)
pub fn shrink_to_fit(&mut self)
Shrinks the capacity of the MutableUtf8Array
to fit its current length.
sourcepub fn into_data(self) -> (DataType, Offsets<O>, Vec<u8>, Option<MutableBitmap>)
pub fn into_data(self) -> (DataType, Offsets<O>, Vec<u8>, Option<MutableBitmap>)
Extract the low-end APIs from the MutableUtf8Array
.
sourcepub fn values_iter(&self) -> ArrayValuesIter<'_, MutableUtf8ValuesArray<O>> ⓘ
pub fn values_iter(&self) -> ArrayValuesIter<'_, MutableUtf8ValuesArray<O>> ⓘ
Returns an iterator of &str
sourcepub fn set_validity(&mut self, validity: Option<MutableBitmap>)
pub fn set_validity(&mut self, validity: Option<MutableBitmap>)
Sets the validity.
§Panic
Panics iff the validity’s len is not equal to the existing values’ length.
sourcepub fn apply_validity<F>(&mut self, f: F)
pub fn apply_validity<F>(&mut self, f: F)
source§impl<O> MutableUtf8Array<O>where
O: Offset,
impl<O> MutableUtf8Array<O>where
O: Offset,
source§impl<O> MutableUtf8Array<O>where
O: Offset,
impl<O> MutableUtf8Array<O>where
O: Offset,
sourcepub fn extend_trusted_len_values<I, P>(&mut self, iterator: I)
pub fn extend_trusted_len_values<I, P>(&mut self, iterator: I)
Extends the MutableUtf8Array
from an iterator of values of trusted len.
This differs from extended_trusted_len
which accepts iterator of optional values.
sourcepub fn extend_values<I, P>(&mut self, iterator: I)
pub fn extend_values<I, P>(&mut self, iterator: I)
Extends the MutableUtf8Array
from an iterator of values.
This differs from extended_trusted_len
which accepts iterator of optional values.
sourcepub unsafe fn extend_trusted_len_values_unchecked<I, P>(&mut self, iterator: I)
pub unsafe fn extend_trusted_len_values_unchecked<I, P>(&mut self, iterator: I)
Extends the MutableUtf8Array
from an iterator of values of trusted len.
This differs from extended_trusted_len_unchecked
which accepts iterator of optional
values.
§Safety
The iterator must be trusted len.
sourcepub fn extend_trusted_len<I, P>(&mut self, iterator: I)
pub fn extend_trusted_len<I, P>(&mut self, iterator: I)
Extends the MutableUtf8Array
from an iterator of trusted len.
sourcepub unsafe fn extend_trusted_len_unchecked<I, P>(&mut self, iterator: I)
pub unsafe fn extend_trusted_len_unchecked<I, P>(&mut self, iterator: I)
sourcepub unsafe fn from_trusted_len_iter_unchecked<I, P>(
iterator: I
) -> MutableUtf8Array<O>
pub unsafe fn from_trusted_len_iter_unchecked<I, P>( iterator: I ) -> MutableUtf8Array<O>
Creates a MutableUtf8Array
from an iterator of trusted length.
§Safety
The iterator must be TrustedLen
.
I.e. that size_hint().1
correctly reports its length.
sourcepub fn from_trusted_len_iter<I, P>(iterator: I) -> MutableUtf8Array<O>
pub fn from_trusted_len_iter<I, P>(iterator: I) -> MutableUtf8Array<O>
Creates a MutableUtf8Array
from an iterator of trusted length.
sourcepub unsafe fn from_trusted_len_values_iter_unchecked<T, I>(
iterator: I
) -> MutableUtf8Array<O>
pub unsafe fn from_trusted_len_values_iter_unchecked<T, I>( iterator: I ) -> MutableUtf8Array<O>
Creates a MutableUtf8Array
from an iterator of trusted length of &str
.
§Safety
The iterator must be TrustedLen
.
I.e. that size_hint().1
correctly reports its length.
sourcepub fn from_trusted_len_values_iter<T, I>(iterator: I) -> MutableUtf8Array<O>
pub fn from_trusted_len_values_iter<T, I>(iterator: I) -> MutableUtf8Array<O>
Creates a new MutableUtf8Array
from a TrustedLen
of &str
.
sourcepub unsafe fn try_from_trusted_len_iter_unchecked<E, I, P>(
iterator: I
) -> Result<MutableUtf8Array<O>, E>
pub unsafe fn try_from_trusted_len_iter_unchecked<E, I, P>( iterator: I ) -> Result<MutableUtf8Array<O>, E>
Creates a MutableUtf8Array
from an falible iterator of trusted length.
§Safety
The iterator must be TrustedLen
.
I.e. that size_hint().1
correctly reports its length.
sourcepub fn try_from_trusted_len_iter<E, I, P>(
iterator: I
) -> Result<MutableUtf8Array<O>, E>
pub fn try_from_trusted_len_iter<E, I, P>( iterator: I ) -> Result<MutableUtf8Array<O>, E>
Creates a MutableUtf8Array
from an falible iterator of trusted length.
sourcepub fn from_iter_values<T, I>(iterator: I) -> MutableUtf8Array<O>
pub fn from_iter_values<T, I>(iterator: I) -> MutableUtf8Array<O>
Creates a new MutableUtf8Array
from a Iterator
of &str
.
sourcepub fn extend_fallible<T, I, E>(&mut self, iter: I) -> Result<(), E>
pub fn extend_fallible<T, I, E>(&mut self, iter: I) -> Result<(), E>
Extend with a fallible iterator
Trait Implementations§
source§impl<O> Clone for MutableUtf8Array<O>
impl<O> Clone for MutableUtf8Array<O>
source§fn clone(&self) -> MutableUtf8Array<O>
fn clone(&self) -> MutableUtf8Array<O>
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl<O> Debug for MutableUtf8Array<O>
impl<O> Debug for MutableUtf8Array<O>
source§impl<O> Default for MutableUtf8Array<O>where
O: Offset,
impl<O> Default for MutableUtf8Array<O>where
O: Offset,
source§fn default() -> MutableUtf8Array<O>
fn default() -> MutableUtf8Array<O>
source§impl<O, T> Extend<Option<T>> for MutableUtf8Array<O>
impl<O, T> Extend<Option<T>> for MutableUtf8Array<O>
source§fn extend<I>(&mut self, iter: I)where
I: IntoIterator<Item = Option<T>>,
fn extend<I>(&mut self, iter: I)where
I: IntoIterator<Item = Option<T>>,
source§fn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)source§fn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)source§impl<O> From<MutableUtf8Array<O>> for Utf8Array<O>where
O: Offset,
impl<O> From<MutableUtf8Array<O>> for Utf8Array<O>where
O: Offset,
source§fn from(other: MutableUtf8Array<O>) -> Utf8Array<O>
fn from(other: MutableUtf8Array<O>) -> Utf8Array<O>
source§impl<O> From<MutableUtf8ValuesArray<O>> for MutableUtf8Array<O>where
O: Offset,
impl<O> From<MutableUtf8ValuesArray<O>> for MutableUtf8Array<O>where
O: Offset,
source§fn from(other: MutableUtf8ValuesArray<O>) -> MutableUtf8Array<O>
fn from(other: MutableUtf8ValuesArray<O>) -> MutableUtf8Array<O>
source§impl<O, P> FromIterator<Option<P>> for MutableUtf8Array<O>
impl<O, P> FromIterator<Option<P>> for MutableUtf8Array<O>
source§fn from_iter<I>(iter: I) -> MutableUtf8Array<O>where
I: IntoIterator<Item = Option<P>>,
fn from_iter<I>(iter: I) -> MutableUtf8Array<O>where
I: IntoIterator<Item = Option<P>>,
source§impl<'a, O> IntoIterator for &'a MutableUtf8Array<O>where
O: Offset,
impl<'a, O> IntoIterator for &'a MutableUtf8Array<O>where
O: Offset,
§type IntoIter = ZipValidity<&'a str, ArrayValuesIter<'a, MutableUtf8ValuesArray<O>>, BitmapIter<'a>>
type IntoIter = ZipValidity<&'a str, ArrayValuesIter<'a, MutableUtf8ValuesArray<O>>, BitmapIter<'a>>
source§fn into_iter(self) -> <&'a MutableUtf8Array<O> as IntoIterator>::IntoIter
fn into_iter(self) -> <&'a MutableUtf8Array<O> as IntoIterator>::IntoIter
source§impl<O> MutableArray for MutableUtf8Array<O>where
O: Offset,
impl<O> MutableArray for MutableUtf8Array<O>where
O: Offset,
source§fn validity(&self) -> Option<&MutableBitmap>
fn validity(&self) -> Option<&MutableBitmap>
source§fn as_arc(&mut self) -> Arc<dyn Array>
fn as_arc(&mut self) -> Arc<dyn Array>
Array
.source§fn as_mut_any(&mut self) -> &mut (dyn Any + 'static)
fn as_mut_any(&mut self) -> &mut (dyn Any + 'static)
Any
, to enable dynamic casting.source§fn shrink_to_fit(&mut self)
fn shrink_to_fit(&mut self)
source§impl<O> PartialEq for MutableUtf8Array<O>where
O: Offset,
impl<O> PartialEq for MutableUtf8Array<O>where
O: Offset,
source§fn eq(&self, other: &MutableUtf8Array<O>) -> bool
fn eq(&self, other: &MutableUtf8Array<O>) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl<O, T> TryExtend<Option<T>> for MutableUtf8Array<O>
impl<O, T> TryExtend<Option<T>> for MutableUtf8Array<O>
source§fn try_extend<I>(&mut self, iter: I) -> Result<(), Error>where
I: IntoIterator<Item = Option<T>>,
fn try_extend<I>(&mut self, iter: I) -> Result<(), Error>where
I: IntoIterator<Item = Option<T>>,
Extend::extend
.source§impl<O> TryExtendFromSelf for MutableUtf8Array<O>where
O: Offset,
impl<O> TryExtendFromSelf for MutableUtf8Array<O>where
O: Offset,
source§fn try_extend_from_self(
&mut self,
other: &MutableUtf8Array<O>
) -> Result<(), Error>
fn try_extend_from_self( &mut self, other: &MutableUtf8Array<O> ) -> Result<(), Error>
other
, failing only on overflow.Auto Trait Implementations§
impl<O> Freeze for MutableUtf8Array<O>
impl<O> RefUnwindSafe for MutableUtf8Array<O>
impl<O> Send for MutableUtf8Array<O>
impl<O> Sync for MutableUtf8Array<O>
impl<O> Unpin for MutableUtf8Array<O>where
O: Unpin,
impl<O> UnwindSafe for MutableUtf8Array<O>where
O: UnwindSafe,
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CheckedAs for T
impl<T> CheckedAs for T
source§fn checked_as<Dst>(self) -> Option<Dst>where
T: CheckedCast<Dst>,
fn checked_as<Dst>(self) -> Option<Dst>where
T: CheckedCast<Dst>,
source§impl<Src, Dst> CheckedCastFrom<Src> for Dstwhere
Src: CheckedCast<Dst>,
impl<Src, Dst> CheckedCastFrom<Src> for Dstwhere
Src: CheckedCast<Dst>,
source§fn checked_cast_from(src: Src) -> Option<Dst>
fn checked_cast_from(src: Src) -> Option<Dst>
source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.