Struct Strings 

pub struct Strings<BC = Vec<u64>, VC = Vec<u8>> {
    pub bounds: BC,
    pub values: VC,
}

A stand-in for Vec<String>.

The reference type for Strings is &[u8] rather than &str to remove utf8 validation from the critical path of reads. You get to make the call about whether and how you’d like to manage this validation. The copy_from and into_owned methods panic on invalid data.

Fields

bounds: BC

Bounds container; provides indexed access to offsets.

values: VC

Values container; provides slice access to bytes.

Implementations

impl<'a, BC: Len + IndexAs<u64>> Strings<BC, &'a [u8]>

pub fn get_str(&self, index: usize) -> &'a str

Returns the index-th string as &str, validating UTF-8.

This is a convenience wrapper around Index::get (which returns &[u8]) for callers who need &str. The UTF-8 validation has a measurable cost; use get directly if you can work with &[u8].

Trait Implementations

impl<'a, BC: AsBytes<'a>, VC: AsBytes<'a>> AsBytes<'a> for Strings<BC, VC>

fn as_bytes(&self) -> impl Iterator<Item = (u64, &'a [u8])>

Presents self as a sequence of byte slices, with their required alignment.

impl<BC: BorrowIndexAs<u64>> Borrow for Strings<BC, Vec<u8>>

type Ref<'a> = &'a [u8]

For each lifetime, a reference with that lifetime.

type Borrowed<'a> = Strings<<BC as Borrow>::Borrowed<'a>, &'a [u8]> where BC: 'a

The type of a borrowed container.

fn borrow<'a>(&'a self) -> Self::Borrowed<'a>

Converts a reference to the type to a borrowed variant.

fn reborrow<'c, 'a: 'c>(thing: Self::Borrowed<'a>) -> Self::Borrowed<'c>

where BC: 'a,

Reborrows the borrowed type to a shorter lifetime. See Columnar::reborrow for details.

fn reborrow_ref<'b, 'a: 'b>(thing: Self::Ref<'a>) -> Self::Ref<'b>

where Self: 'a,

Reborrows the borrowed type to a shorter lifetime. See Columnar::reborrow for details.

impl<BC: Clear, VC: Clear> Clear for Strings<BC, VC>

fn clear(&mut self)

Clears self, without changing its capacity.

impl<BC: Clone, VC: Clone> Clone for Strings<BC, VC>

fn clone(&self) -> Strings<BC, VC>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<BC: PushIndexAs<u64>> Container for Strings<BC, Vec<u8>>

fn extend_from_self(&mut self, other: Self::Borrowed<'_>, range: Range<usize>)

Extends self by a range in other.

fn reserve_for<'a, I>(&mut self, selves: I)

where Self: 'a, I: Iterator<Item = Self::Borrowed<'a>> + Clone,

fn with_capacity_for<'a, I>(selves: I) -> Self

where Self: 'a, I: Iterator<Item = Self::Borrowed<'a>> + Clone,

Allocates an empty container that can be extended by selves without reallocation.

impl<BC: Debug, VC: Debug> Debug for Strings<BC, VC>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<BC: Default, VC: Default> Default for Strings<BC, VC>

fn default() -> Strings<BC, VC>

Returns the “default value” for a type.

impl<'a, BC: FromBytes<'a>, VC: FromBytes<'a>> FromBytes<'a> for Strings<BC, VC>

const SLICE_COUNT: usize

The number of byte slices this type consumes when reconstructed.

fn from_bytes(bytes: &mut impl Iterator<Item = &'a [u8]>) -> Self

Reconstructs self from a sequence of correctly aligned and sized bytes slices.

fn from_store(store: &DecodedStore<'a>, offset: &mut usize) -> Self

Reconstructs self from a DecodedStore, using direct random access at a given offset.

fn element_sizes(sizes: &mut Vec<usize>) -> Result<(), String>

Reports the element sizes (in bytes) for each slice this type consumes.

fn validate(slices: &[(&[u64], u8)]) -> Result<(), String>

where Self: Sized,

Validates that the given slices are compatible with this type.

impl<'a, BC: Len + IndexAs<u64>> Index for &'a Strings<BC, Vec<u8>>

type Ref = &'a [u8]

The type returned by the get method.

fn get(&self, index: usize) -> Self::Ref

Returns the reference type for location index.

fn last(&self) -> Option<Self::Ref>

where Self: Len,

fn index_iter(&self) -> IterOwn<&Self>

Converts &self into an iterator.

fn into_index_iter(self) -> IterOwn<Self>

where Self: Sized,

Converts self into an iterator.

impl<'a, BC: Len + IndexAs<u64>> Index for Strings<BC, &'a [u8]>

type Ref = &'a [u8]

The type returned by the get method.

fn get(&self, index: usize) -> Self::Ref

Returns the reference type for location index.

fn last(&self) -> Option<Self::Ref>

where Self: Len,

fn index_iter(&self) -> IterOwn<&Self>

Converts &self into an iterator.

fn into_index_iter(self) -> IterOwn<Self>

where Self: Sized,

Converts self into an iterator.

impl<BC: Len, VC> Len for Strings<BC, VC>

fn len(&self) -> usize

The number of contained elements.

fn is_empty(&self) -> bool

Whether this contains no elements.

impl<BC: PartialEq, VC: PartialEq> PartialEq for Strings<BC, VC>

fn eq(&self, other: &Strings<BC, VC>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<BC: for<'a> Push<&'a u64>> Push<&[u8]> for Strings<BC>

fn push(&mut self, item: &[u8])

Pushes an item onto self.

fn extend(&mut self, iter: impl IntoIterator<Item = T>)

Pushes elements of an iterator onto self.

impl<'a, 'b, BC: for<'c> Push<&'c u64>> Push<&'b Arguments<'a>> for Strings<BC>

fn push(&mut self, item: &'b Arguments<'a>)

Pushes an item onto self.

fn extend(&mut self, iter: impl IntoIterator<Item = T>)

Pushes elements of an iterator onto self.

impl<BC: for<'a> Push<&'a u64>> Push<&Box<str>> for Strings<BC>

fn push(&mut self, item: &Box<str>)

Pushes an item onto self.

fn extend(&mut self, iter: impl IntoIterator<Item = T>)

Pushes elements of an iterator onto self.

impl<BC: for<'a> Push<&'a u64>> Push<&String> for Strings<BC>

fn push(&mut self, item: &String)

Pushes an item onto self.

fn extend(&mut self, iter: impl IntoIterator<Item = T>)

Pushes elements of an iterator onto self.

impl<BC: for<'a> Push<&'a u64>> Push<&str> for Strings<BC>

fn push(&mut self, item: &str)

Pushes an item onto self.

fn extend(&mut self, iter: impl IntoIterator<Item = T>)

Pushes elements of an iterator onto self.

impl<'a, BC: for<'b> Push<&'b u64>> Push<Arguments<'a>> for Strings<BC>

fn push(&mut self, item: Arguments<'a>)

Pushes an item onto self.

fn extend(&mut self, iter: impl IntoIterator<Item = T>)

Pushes elements of an iterator onto self.

impl<BC: Copy, VC: Copy> Copy for Strings<BC, VC>

impl<BC, VC> StructuralPartialEq for Strings<BC, VC>