Method map

src/sharedref.rs:418–435

Converts the inner value by the given function. Typically `T` is a static reference to a collection, and `U` is an iterator of that collection. # Panics Panics if the underlying reference has been invalidated. This is typically called immediately after the `UnsafePyLeaked` is obtained. At this time, the reference must be valid and no panic would occur. # Safety The lifetime of the object pas

(self, py: Python, f: impl FnOnce(T) -> U)

    /// corresponding `UnsafePyLeaked` is alive. Do not copy it out of the
    /// function call.
    pub unsafe fn map<U>(self, py: Python, f: impl FnOnce(T) -> U) -> UnsafePyLeaked<U> {
        // Needs to test the generation value to make sure self.data reference
        // is still intact.
        self.validate_generation(py)
            .expect("map() over invalidated leaked reference");

        // f() could make the self.data outlive. That's why map() is unsafe.
        // In order to make this function safe, maybe we'll need a way to
        // temporarily restrict the lifetime of self.data and translate the
        // returned object back to Something<'static>.
        let new_data = f(self.data);
        UnsafePyLeaked {
            owner: self.owner,
            state: self.state,
            generation: self.generation,
            data: new_data,
        }
    }
}

/// An immutably borrowed reference to a leaked value.