Doc for Store::retrieve_copy()
This commit is contained in:
parent
1f47db3951
commit
c82d7bf7bc
1 changed files with 16 additions and 0 deletions
|
@ -663,6 +663,22 @@ impl Store {
|
||||||
|
|
||||||
/// Retrieve a copy of a given entry, this cannot be used to mutate
|
/// Retrieve a copy of a given entry, this cannot be used to mutate
|
||||||
/// the one on disk
|
/// the one on disk
|
||||||
|
///
|
||||||
|
/// TODO: Create Hooks for retrieving a copy
|
||||||
|
///
|
||||||
|
/// # Executed Hooks
|
||||||
|
///
|
||||||
|
/// - (none yet)
|
||||||
|
///
|
||||||
|
/// # Return value
|
||||||
|
///
|
||||||
|
/// On success: Entry
|
||||||
|
///
|
||||||
|
/// On error:
|
||||||
|
/// - RetrieveCopyCallError(LockPoisoned()) if the internal write lock cannot be aquierd.
|
||||||
|
/// - RetrieveCopyCallError(IdLocked()) if the Entry is borrowed currently
|
||||||
|
/// - Errors StoreEntry::new() might return
|
||||||
|
///
|
||||||
pub fn retrieve_copy<S: IntoStoreId>(&self, id: S) -> Result<Entry> {
|
pub fn retrieve_copy<S: IntoStoreId>(&self, id: S) -> Result<Entry> {
|
||||||
let id = try!(id.into_storeid()).with_base(self.path().clone());
|
let id = try!(id.into_storeid()).with_base(self.path().clone());
|
||||||
let entries = match self.entries.write() {
|
let entries = match self.entries.write() {
|
||||||
|
|
Loading…
Reference in a new issue