#reference-data #ownership #cell #pattern #offers #stored #transferring

offer-cell

A rust library that defines a pattern for providing a reference to stored data, and optionally transferring ownership of that data

3 releases

0.1.2 Aug 6, 2024
0.1.1 Aug 6, 2024
0.1.0 Aug 5, 2024

#1 in #transferring

MIT license

7KB
102 lines

Offer Cell

A rust library that defines a pattern for providing a reference to stored data, and optionally transferring ownership of that data.

Usage

Initialization

// a cell may be created
let cell = OfferCell::new(42);

// or initialzed as empty
let empty = OfferCell::empty();

Accessing Data

// access the item as a reference
match cell.item() {
    Some(value) = (), // do something with the value
    None => (), // returns none if there is no item
}

// access the item as a mutable reference
match cell.item_mut() {
    Some(value) = (), // do something with the value
    None => (), // returns none if there is no item
}

Offering Data

What sets this apart, is the data within the cell can be "offered"

// if the cell contains an item, it can be offered
let offered = cell.offer() {
    Some(offered) => offered,
    None => return,
};

// the offered item implements Deref and DerefMut
assert_eq!(offered.deref(), &42);

// if nothing else is done with the offered item,
// the data will stay in the cell for later

// alternatively the offering can be consumed
// this leaves nothing in the cell, and takes ownership of the data
let data = offered.take();

No runtime deps