Bound in core::ops - Rust
Skip to main content Bound core :: ops Enum Bound 1.26.0 · Source pub enum Bound<T> { Included(T), Excluded(T), Unbounded, } Expand description An endpoint of a range of keys. § Examples Bound s are range endpoints: use std::ops::Bound:: * ; use std::ops::RangeBounds; assert_eq! ((.. 100 ).start_bound(), Unbounded); assert_eq! (( 1 .. 12 ).start_bound(), Included( & 1 )); assert_eq! (( 1 .. 12 ).end_bound(), Excluded( & 12 )); Using a tuple of Bound s as an argument to BTreeMap::range .
Note that in most cases, it’s better to use range syntax ( 1..5 ) instead. use std::collections::BTreeMap; use std::ops::Bound::{Excluded, Included, Unbounded}; let mut map = BTreeMap::new(); map.insert( 3 , "a" ); map.insert( 5 , "b" ); map.insert( 8 , "c" ); for (key, value) in map.range((Excluded( 3 ), Included( 8 ))) { println! ( "{key}: {value}" ); } assert_eq! ( Some (( & 3 , & "a" )), map.range((Unbounded, Included( 5 ))).next()); Variants § § 1.26.0 Included(T) An inclusive bound. § 1.26.0 Excluded(T) An exclusive bound. § 1.26.0 Unbounded An infinite endpoint.
Indicates that there is no bound in this direction. Implementations § Source § impl<T> Bound <T> 1.65.0 (const: unstable) · Source pub fn as_ref (&self) -> Bound < &T > Converts from &Bound<T> to Bound<&T> . Source pub const fn as_mut (&mut self) -> Bound < &mut T > 🔬 This is a nightly-only experimental API. ( bound_as_ref #80996 ) Converts from &mut Bound<T> to Bound<&mut T> . 1.77.0 · Source pub fn map <U, F: FnOnce (T) -> U>(self, f: F) -> Bound <U> Maps a Bound<T> to a Bound<U> by applying a function to the contained value (including both Included and Excluded ), returning a Bound of the same kind. § Examples use std::ops::Bound:: * ; let bound_string = Included( "Hello, World!" ); assert_eq! (bound_string.map(|s| s.len()), Included( 13 )); use std::ops::Bound; use Bound:: * ; let unbounded_string: Bound<String> = Unbounded; assert_eq! (unbounded_string.map(|s| s.len()), Unbounded); Source § impl<T: Copy > Bound < &T > Source pub const fn copied (self) -> Bound <T> 🔬 This is a nightly-only experimental API. ( bound_copied #145966 ) Map a Bound<&T> to a Bound<T> by copying the contents of the bound. § Examples #![feature(bound_copied)] use std::ops::Bound:: * ; use std::ops::RangeBounds; assert_eq! (( 1 ..
12 ).start_bound(), Included( & 1 )); assert_eq! (( 1 .. 12 ).start_bound().copied(), Included( 1 )); Source § impl<T: Clone > Bound < &T > 1.55.0 (const: unstable) · Source pub fn cloned (self) -> Bound <T> where T: Clone , Map a Bound<&T> to a Bound<T> by cloning the contents of the bound. § Examples use std::ops::Bound:: * ; use std::ops::RangeBounds; let a1 = String::from( "a" ); let (a2, a3, a4) = (a1.clone(), a1.clone(), a1.clone()); assert_eq! (Included( & a1), (a2..).start_bound()); assert_eq! (Included(a3), (a4..).start_bound().cloned()); Trait Implementations § 1.17.0 (const: unstable ) · Source § impl<T: Clone > Clone for Bound <T> Source § fn clone (&self) -> Self Returns a duplicate of the value.
Read more 1.0.0 (const: unstable ) · Source § fn clone_from (&mut self, source: &Self) where Self:, Performs copy-assignment from source . Read more 1.17.0 · Source § impl<T: Copy > Copy for Bound <T> 1.17.0 · Source § impl<T: Debug > Debug for Bound <T> Source § fn fmt (&self, f: &mut Formatter <'_>) -> Result Formats the value using the given formatter. Read more 1.17.0 (const: unstable ) · Source § impl<T: Eq > Eq for Bound <T> 1.17.0 · Source § impl<T: Hash > Hash for Bound <T> Source § fn hash <__H: Hasher >(&self, state: &mut __H ) Feeds this value into the given Hasher .
Read more 1.3.0 · Source § fn hash_slice <H: Hasher >(data: &[Self], state: &mut H ) where Self: Sized , Feeds a slice of this type into the given Hasher . Read more 1.17.0 (const: unstable ) · Source § impl<T: PartialEq > PartialEq for Bound <T> Source § fn eq (&self, other: &Self) -> bool Equality operator == . Read more 1.0.0 (const: unstable ) · Source § fn ne (&self, other: &Rhs ) -> bool Inequality operator != .
Read more 1.17.0 · Source § impl<T: PartialEq > StructuralPartialEq for Bound <T> Auto Trait Implementations § § impl<T> Forget for Bound <T> § impl<T> Freeze for Bound <T> where T: Freeze , § impl<T> Move for Bound <T> where T: Move , § impl<T> RefUnwindSafe for Bound <T> where T: RefUnwindSafe , § impl<T> Send for Bound <T> where T: Send , § impl<T> Sync for Bound <T> where T: Sync , § impl<T> Unpin for Bound <T> where T: Unpin , § impl<T> UnsafeUnpin for Bound <T> where T: UnsafeUnpin , § impl<T> UnwindSafe for Bound <T> where T: UnwindSafe , Blanket Implementations § Source § impl<T> Any for T where T: 'static + ?
Sized , Source § fn type_id (&self) -> TypeId Gets the TypeId of self . Read more Source § impl<T> Borrow <T> for T where T: ? Sized , Source § fn borrow (&self) -> &T Immutably borrows from an owned value. Read more Source § impl<T> BorrowMut <T> for T where T: ? Sized , Source § fn borrow_mut (&mut self) -> &mut T Mutably borrows from an owned value. Read more Source § impl<T> CloneToUninit for T where T: Clone , Source § unsafe fn clone_to_uninit (&self, dest: *mut u8 ) 🔬 This is a nightly-only experimental API. ( clone_to_uninit #126799 ) Performs copy-assignment from self to dest .
Read more Source § impl<T> From <T> for T Source § fn from (t: T) -> T Returns the argument unchanged. Source § impl<T, U> Into <U> for T where U: From <T>, Source § fn into (self) -> U Calls U::from(self) . That is, this conversion is whatever the implementation of From <T> for U chooses to do. Source § impl<T, U> TryFrom <U> for T where U: Into <T>, Source § type Error = ! The type returned in the event of a conversion error.
Source § fn try_from (value: U) -> Result <T, ! > Performs the conversion. Source § impl<T, U> TryInto <U> for T where U: TryFrom <T>, Source § type Error = <U as TryFrom <T>>:: Error The type returned in the event of a conversion error. Source § fn try_into (self) -> Result <U, <U as TryFrom <T>>:: Error > Performs the conversion.