# Maybe Owned values

Documentation Crate informations Repository

This crate provides two simple wrappers Mown and MownMut for values that can be either owned or borrowed. The type Mown is an simple enum type with two constructors:

```rust pub trait ToOwned { type Owned: Borrow; }

pub enum Mown<'a, T: ToOwned> { Owned(T::Owned), Borrowed(&'a T) } ```

The mutable version MownMut follows the same definition with a mutable reference. This is very similar to the standard Cow type, except that it is not possible to transform a borrowed value into an owned one. This is also slightly different from the similar crate boow since the ToOwned trait allow for the use of Mown with unsized types (for instance Mown<str>) and with mutable references.

Basic Usage

One basic use case for the Mown type is the situation where one wants to reuse some input borrowed value under some condition, or then use a custom owned value.

```rust use mown::Mown;

fn function(inputvalue: &String) -> Mown { if condition { Mown::Borrowed(inputvalue) } else { let customvalue: String = "foo".tostring() + inputvalue + "bar" ; Mown::Owned(customvalue) } } ```

One can also wrap unsized types for which the provided ToOwned trait has been implemented. This is the case for the unsized str type with the sized owned type String.

```rust use mown::Mown;

fn function(inputvalue: &str) -> Mown { let value = if condition { Mown::Borrowed(inputvalue) } else { let customvalue: String = "foo".tostring() + inputvalue.tostring() + "bar" ; Mown::Owned(custom_value) } } ```

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.