Struct VectoredSubset

pub struct VectoredSubset<'string, 'slice> {
    pub range: Range,
    /* private fields */
}

Available on crate feature vectored only.

A “ragged” subset of VectoredByteSlices.

This struct is able to reference a contiguous subset of the vectored string data contained in a VectoredByteSlices, including any “ragged” start or end component which does not span the entirety of the corresponding slice from the input data. This allows the match callback provided to scan_sync_vectored() to receive VectoredMatch instances that reference the input data without introducing any additional dynamic allocations.

Fields

range: Range

The offsets for the entire match, without reference to the data slices.

Implementations

impl<'string, 'slice> VectoredSubset<'string, 'slice>

pub fn iter_slices( &self, ) -> impl ExactSizeIterator<Item = ByteSlice<'string>> + DoubleEndedIterator + '_

Iterate over the referenced data.

 use vectorscan::sources::VectoredByteSlices;

 let b1 = "asdf";
 let b2 = "ok";
 let b3 = "bsdf";
 let bb = [b1.into(), b2.into(), b3.into()];
 let bs = VectoredByteSlices::from_slices(&bb);

 let sub = bs.index_range(2..8).unwrap();
 let collected: Vec<&str> = sub.iter_slices().map(|s| unsafe { s.as_str() }).collect();
 assert_eq!(&collected, &["df", "ok", "bs"]);

This iterator is the only interface exposed to access the data because “ragged” start and end components cannot be expressed as simple subslices of the vectored data in a VectoredByteSlices, so the first and/or last iteration result must come from additional references to ragged substrings which are also stored in this struct.

Trait Implementations

impl<'string, 'slice> Clone for VectoredSubset<'string, 'slice>

fn clone(&self) -> VectoredSubset<'string, 'slice>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'string, 'slice> Debug for VectoredSubset<'string, 'slice>

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

Formats the value using the given formatter.

impl<'string, 'slice> Hash for VectoredSubset<'string, 'slice>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'string, 'slice> Ord for VectoredSubset<'string, 'slice>

fn cmp(&self, other: &VectoredSubset<'string, 'slice>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'string, 'slice> PartialEq for VectoredSubset<'string, 'slice>

fn eq(&self, other: &VectoredSubset<'string, 'slice>) -> 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<'string, 'slice> PartialOrd for VectoredSubset<'string, 'slice>

fn partial_cmp( &self, other: &VectoredSubset<'string, 'slice>, ) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'string, 'slice> Copy for VectoredSubset<'string, 'slice>

impl<'string, 'slice> Eq for VectoredSubset<'string, 'slice>

impl<'string, 'slice> StructuralPartialEq for VectoredSubset<'string, 'slice>