Text of rust.docs.kernel.org › next › core › ops › enum.Bound.html as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

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.