pub struct ExcelOwnedValue<'call> { /* private fields */ }Expand description
A callback-scoped owner for one result root written by Excel.
The lifetime prevents the owner from outliving the backend/callback
capability. The raw-pointer marker deliberately makes this type neither
Send nor Sync; copy to ExcelValue before crossing threads.
ⓘ
use excel_api::ExcelOwnedValue;
fn require_send<T: Send>() {}
require_send::<ExcelOwnedValue<'static>>();Implementations§
Source§impl<'call> ExcelOwnedValue<'call>
impl<'call> ExcelOwnedValue<'call>
Sourcepub fn as_value_ref(&self) -> Result<ExcelValueRef<'_>, DecodeError>
pub fn as_value_ref(&self) -> Result<ExcelValueRef<'_>, DecodeError>
Borrows the active result through the central ownership-bit-masking decoder.
Sourcepub fn to_owned_value(
&self,
limits: &ConversionLimits,
) -> Result<ExcelValue, ConversionError>
pub fn to_owned_value( &self, limits: &ConversionLimits, ) -> Result<ExcelValue, ConversionError>
Deep-copies without consuming or releasing this result.
Sourcepub fn into_owned_value(
self,
limits: &ConversionLimits,
) -> Result<ExcelValue, ExcelOwnedConversionError>
pub fn into_owned_value( self, limits: &ConversionLimits, ) -> Result<ExcelValue, ExcelOwnedConversionError>
Deep-copies and then consumes the Excel release obligation.
Sourcepub fn release(self) -> Result<(), ExcelReleaseError>
pub fn release(self) -> Result<(), ExcelReleaseError>
Explicitly consumes this owner and attempts any required release once.
Sourcepub fn into_xlfree_transfer(self) -> ExcelXlFreeTransfer<'call>
pub fn into_xlfree_transfer(self) -> ExcelXlFreeTransfer<'call>
Consumes this owner into a non-duplicable pre-commit transfer token.
No ownership bit is changed and no raw pointer is exposed here. The final thunk integration remains deliberately crate-internal work for Prompt 08.
Trait Implementations§
Source§impl Debug for ExcelOwnedValue<'_>
impl Debug for ExcelOwnedValue<'_>
Source§impl Drop for ExcelOwnedValue<'_>
impl Drop for ExcelOwnedValue<'_>
Auto Trait Implementations§
impl<'call> !RefUnwindSafe for ExcelOwnedValue<'call>
impl<'call> !Send for ExcelOwnedValue<'call>
impl<'call> !Sync for ExcelOwnedValue<'call>
impl<'call> !UnwindSafe for ExcelOwnedValue<'call>
impl<'call> Freeze for ExcelOwnedValue<'call>
impl<'call> Unpin for ExcelOwnedValue<'call>
impl<'call> UnsafeUnpin for ExcelOwnedValue<'call>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more