pub struct SliceBias {
    pub start: BiasDirection,
    pub end: BiasDirection,
}
Available on crate feature slices only.
Expand description

What directions SliceExt::{slice_lossy, slice_lossy_mut} are biased towards.

For str this has the effect of going in those directions if the start and/or end bound is between char boundaries.

For [T] this has no effect and it is recommended to use () as a parameter instead (() is converted to SliceBias::OUT).

Example

String

use core_extensions::SliceExt;
use core_extensions::slices::SliceBias;

let word = "niño";

assert_eq!(
    word.char_indices().collect::<Vec<_>>(),
    &[(0, 'n'), (1, 'i'), (2, 'ñ'), (4, 'o')]
);

assert_eq!(word.slice_lossy(0..1000, ()), word);
assert_eq!(word.slice_lossy(10..10000, ()), "");
assert_eq!(word.slice_lossy(0..4, ()), "niñ");
assert_eq!(word.slice_lossy(0..3, ()), "niñ");
assert_eq!(word.slice_lossy(0..2, ()), "ni");
assert_eq!(word.slice_lossy(3..3, ()), "ñ");
assert_eq!(word.slice_lossy(3..4, ()), "ñ");
assert_eq!(word.slice_lossy(2..3, ()), "ñ");

assert_eq!(word.slice_lossy(0..1000, SliceBias::OUT), word);
assert_eq!(word.slice_lossy(10..10000, SliceBias::OUT), "");
assert_eq!(word.slice_lossy(0..4, SliceBias::OUT), "niñ");
assert_eq!(word.slice_lossy(0..3, SliceBias::OUT), "niñ");
assert_eq!(word.slice_lossy(0..2, SliceBias::OUT), "ni");
assert_eq!(word.slice_lossy(3..3, SliceBias::OUT), "ñ");
assert_eq!(word.slice_lossy(3..4, SliceBias::OUT), "ñ");
assert_eq!(word.slice_lossy(2..3, SliceBias::OUT), "ñ");

assert_eq!(word.slice_lossy(0..10000, SliceBias::IN), word);
assert_eq!(word.slice_lossy(10..10000, SliceBias::IN), "");
assert_eq!(word.slice_lossy(0..4, SliceBias::IN), "niñ");
assert_eq!(word.slice_lossy(0..3, SliceBias::IN), "ni");
assert_eq!(word.slice_lossy(0..2, SliceBias::IN), "ni");
assert_eq!(word.slice_lossy(3..3, SliceBias::IN), "");
assert_eq!(word.slice_lossy(3..4, SliceBias::IN), "");
assert_eq!(word.slice_lossy(2..3, SliceBias::IN), "");

assert_eq!(word.slice_lossy(0..1000, SliceBias::LEFT), word);
assert_eq!(word.slice_lossy(10..10000, SliceBias::LEFT), "");
assert_eq!(word.slice_lossy(0..4, SliceBias::LEFT), "niñ");
assert_eq!(word.slice_lossy(0..3, SliceBias::LEFT), "ni");
assert_eq!(word.slice_lossy(0..2, SliceBias::LEFT), "ni");
assert_eq!(word.slice_lossy(3..3, SliceBias::LEFT), "");
assert_eq!(word.slice_lossy(3..4, SliceBias::LEFT), "ñ");
assert_eq!(word.slice_lossy(2..3, SliceBias::LEFT), "");

assert_eq!(word.slice_lossy(0..1000, SliceBias::RIGHT), word);
assert_eq!(word.slice_lossy(10..10000, SliceBias::RIGHT), "");
assert_eq!(word.slice_lossy(0..4, SliceBias::RIGHT), "niñ");
assert_eq!(word.slice_lossy(0..3, SliceBias::RIGHT), "niñ");
assert_eq!(word.slice_lossy(0..2, SliceBias::RIGHT), "ni");
assert_eq!(word.slice_lossy(3..3, SliceBias::RIGHT), "");
assert_eq!(word.slice_lossy(3..4, SliceBias::RIGHT), "");
assert_eq!(word.slice_lossy(2..3, SliceBias::RIGHT), "ñ");

Fields

start: BiasDirection

bias of the start bound

end: BiasDirection

bias of the end bound

Implementations

Biased inwards, start bounds go right, end bounds go left.

Biased outwards, start bounds go left, end bounds go right.

Biased leftwards, both bounds go left.

Biased rightwards. both bounds go right.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Returns a SliceBias::OUT

Converts to this type from the input type.

Converts to this type from the input type.

Converts to this type from the input type.

Converts to this type from the input type.

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Available on crate feature phantom only.

Gets a PhantomData<Self>. Read more

Available on crate feature phantom only.

Gets a PhantomData<fn() -> Self>, a covariant PhantomData.

Available on crate feature phantom only.

Gets a PhantomData<fn(Self)>, a contravariant PhantomData.

Available on crate feature phantom only.

Gets a PhantomData<fn(Self) -> Self>, an invariant PhantomData.

Available on crate feature phantom only.

Gets a PhantomData<Self>. Read more

Available on crate feature phantom only.

Constructs a PhantomData<fn() -> T>, a covariant PhantomData. Read more

Available on crate feature phantom only.

Gets a PhantomData<fn(Self)>, a contravariant PhantomData. Read more

Available on crate feature phantom only.

Gets a PhantomData<fn(Self) -> Self>, an invariant PhantomData. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Available on crate feature callable only.

For calling CallRef::ref_call_, with the ability to specify the types of the arguments.. Read more

Available on crate feature callable only.

For calling CallMut::mut_call_, with the ability to specify the types of the arguments.. Read more

Available on crate feature callable only.

For calling CallInto::into_call_, with the ability to specify the types of the arguments.. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.