Skip to content

malikolivier/boow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Borrowed-Or-oWned

Provide a Borrowed-Or-oWned smart pointer.

Alternative to Cow for which the Clone trait is not required for the encapsulated type.

Use this crate if you want something like Cow but your type cannot be cloned.

You can find the rustdoc here.

How to use

extern crate boow;
use boow::Bow;
// This struct contains a type for which we cannot know at compile time
// whether it will be owned or borrowed.
struct MyStruct<'a> {
    borrowed_or_owned: Bow<'a, InnerStruct>,
}
struct InnerStruct {
    _stuff: String,
}
impl<'a> MyStruct<'a> {
    // Use borrowed value
    fn from_borrowed(inner: &'a InnerStruct) -> Self {
        Self { borrowed_or_owned: Bow::Borrowed(inner) }
    }
    // Use owned value
    fn from_owned(inner: InnerStruct) -> Self {
        Self { borrowed_or_owned: Bow::Owned(inner) }
    }
}

no_std

If you're interested in using this crate with no_std and the alloc crate, add the following to Cargo.toml:

[dependencies]
boow = { version = "0.1", default-features = false }

About

Borrow-Or-oWned smart pointer

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages