Struct triomphe::Arc

pub struct Arc<T: ?Sized> { /* private fields */ }

An atomically reference counted shared pointer

See the documentation for Arc in the standard library. Unlike the standard library Arc, this Arc does not support weak reference counting.

Implementations

impl<T> Arc<T>

pub fn new(data: T) -> Self

Construct an Arc<T>

pub unsafe fn from_raw(ptr: *const T) -> Self

Reconstruct the Arc<T> from a raw pointer obtained from into_raw()

Note: This raw pointer will be offset in the allocation and must be preceded by the atomic count.

It is recommended to use OffsetArc for this

Safety

• The given pointer must be a valid pointer to T that came from Arc::into_raw.
• After from_raw, the pointer must not be accessed.

pub fn with_raw_offset_arc<F, U>(&self, f: F) -> U

where F: FnOnce(&OffsetArc<T>) -> U,

Temporarily converts |self| into a bonafide OffsetArc and exposes it to the provided callback. The refcount is not modified.

pub fn into_raw_offset(a: Self) -> OffsetArc<T>

Converts an Arc into a OffsetArc. This consumes the Arc, so the refcount is not modified.

pub fn from_raw_offset(a: OffsetArc<T>) -> Self

Converts a OffsetArc into an Arc. This consumes the OffsetArc, so the refcount is not modified.

pub fn try_unwrap(this: Self) -> Result<T, Self>

Returns the inner value, if the Arc has exactly one strong reference.

Otherwise, an Err is returned with the same Arc that was passed in.

Examples

use triomphe::Arc;

let x = Arc::new(3);
assert_eq!(Arc::try_unwrap(x), Ok(3));

let x = Arc::new(4);
let _y = Arc::clone(&x);
assert_eq!(*Arc::try_unwrap(x).unwrap_err(), 4);

impl<T> Arc<[T]>

pub unsafe fn from_raw_slice(ptr: *const [T]) -> Self

Reconstruct the Arc<[T]> from a raw pointer obtained from into_raw().

Arc::from_raw should accept unsized types, but this is not trivial to do correctly until the feature pointer_bytes_offsets is stabilized. This is stopgap solution for slices.

Safety

• The given pointer must be a valid pointer to [T] that came from Arc::into_raw.
• After from_raw_slice, the pointer must not be accessed.

impl<T: ?Sized> Arc<T>

pub fn into_raw(this: Self) -> *const T

Convert the Arc<T> to a raw pointer, suitable for use across FFI

Note: This returns a pointer to the data T, which is offset in the allocation.

It is recommended to use OffsetArc for this.

pub fn as_ptr(&self) -> *const T

Returns the raw pointer.

Same as into_raw except self isn’t consumed.

pub fn borrow_arc(&self) -> ArcBorrow<'_, T>

Produce a pointer to the data that can be converted back to an Arc. This is basically an &Arc<T>, without the extra indirection. It has the benefits of an &T but also knows about the underlying refcount and can be converted into more Arc<T>s if necessary.

pub fn heap_ptr(&self) -> *const c_void

Returns the address on the heap of the Arc itself – not the T within it – for memory reporting.

pub fn ptr_eq(this: &Self, other: &Self) -> bool

Test pointer equality between the two Arcs, i.e. they must be the same allocation

impl<T> Arc<MaybeUninit<T>>

pub fn new_uninit() -> Self

Create an Arc contains an MaybeUninit<T>.

pub fn write(&mut self, val: T) -> &mut T

👎Deprecated since 0.1.7: this function previously was UB and now panics for non-unique Arcs. Use UniqueArc::write instead.

Calls MaybeUninit::write on the value contained.

Panics

If the Arc is not unique.

pub fn as_mut_ptr(&mut self) -> *mut MaybeUninit<T>

Obtain a mutable pointer to the stored MaybeUninit<T>.

pub unsafe fn assume_init(self) -> Arc<T>

Safety

Must initialize all fields before calling this function.

impl<T> Arc<[MaybeUninit<T>]>

pub fn new_uninit_slice(len: usize) -> Self

Create an Arc contains an array [MaybeUninit<T>] of len.

pub fn as_mut_slice(&mut self) -> &mut [MaybeUninit<T>]

👎Deprecated since 0.1.8: this function previously was UB and now panics for non-unique Arcs. Use UniqueArc or get_mut instead.

Obtain a mutable slice to the stored [MaybeUninit<T>].

pub unsafe fn assume_init(self) -> Arc<[T]>

Safety

Must initialize all fields before calling this function.

impl<T: Clone> Arc<T>

pub fn make_mut(this: &mut Self) -> &mut T

Makes a mutable reference to the Arc, cloning if necessary

This is functionally equivalent to Arc::make_mut from the standard library.

If this Arc is uniquely owned, make_mut() will provide a mutable reference to the contents. If not, make_mut() will create a new Arc with a copy of the contents, update this to point to it, and provide a mutable reference to its contents.

This is useful for implementing copy-on-write schemes where you wish to avoid copying things if your Arc is not shared.

pub fn make_unique(this: &mut Self) -> &mut UniqueArc<T>

Makes a UniqueArc from an Arc, cloning if necessary.

If this Arc is uniquely owned, make_unique() will provide a UniqueArc containing this. If not, make_unique() will create a new Arc with a copy of the contents, update this to point to it, and provide a UniqueArc to it.

This is useful for implementing copy-on-write schemes where you wish to avoid copying things if your Arc is not shared.

pub fn unwrap_or_clone(this: Arc<T>) -> T

If we have the only reference to T then unwrap it. Otherwise, clone T and return the clone.

Assuming arc_t is of type Arc<T>, this function is functionally equivalent to (*arc_t).clone(), but will avoid cloning the inner value where possible.

impl<T: ?Sized> Arc<T>

pub fn get_mut(this: &mut Self) -> Option<&mut T>

Provides mutable access to the contents if the Arc is uniquely owned.

pub fn get_unique(this: &mut Self) -> Option<&mut UniqueArc<T>>

Provides unique access to the arc if the Arc is uniquely owned.

pub fn is_unique(&self) -> bool

Whether or not the Arc is uniquely owned (is the refcount 1?).

pub fn count(this: &Self) -> usize

Gets the number of Arc pointers to this allocation

pub fn try_unique(this: Self) -> Result<UniqueArc<T>, Self>

Returns a UniqueArc if the Arc has exactly one strong reference.

Otherwise, an Err is returned with the same Arc that was passed in.

Examples

use triomphe::{Arc, UniqueArc};

let x = Arc::new(3);
assert_eq!(UniqueArc::into_inner(Arc::try_unique(x).unwrap()), 3);

let x = Arc::new(4);
let _y = Arc::clone(&x);
assert_eq!(
    *Arc::try_unique(x).map(UniqueArc::into_inner).unwrap_err(),
    4,
);

impl<H, T> Arc<HeaderSlice<H, [T]>>

pub fn from_header_and_iter<I>(header: H, items: I) -> Self

where I: Iterator<Item = T> + ExactSizeIterator,

Creates an Arc for a HeaderSlice using the given header struct and iterator to generate the slice. The resulting Arc will be fat.

pub fn from_header_and_slice(header: H, items: &[T]) -> Self

where T: Copy,

Creates an Arc for a HeaderSlice using the given header struct and iterator to generate the slice. The resulting Arc will be fat.

pub fn from_header_and_vec(header: H, v: Vec<T>) -> Self

Creates an Arc for a HeaderSlice using the given header struct and vec to generate the slice. The resulting Arc will be fat.

impl<H> Arc<HeaderSlice<H, str>>

pub fn from_header_and_str(header: H, string: &str) -> Self

Creates an Arc for a HeaderSlice using the given header struct and a str slice to generate the slice. The resulting Arc will be fat.

impl<H, T> Arc<HeaderSlice<HeaderWithLength<H>, [T]>>

pub fn into_thin(a: Self) -> ThinArc<H, T>

Converts an Arc into a ThinArc. This consumes the Arc, so the refcount is not modified.

pub fn from_thin(a: ThinArc<H, T>) -> Self

Converts a ThinArc into an Arc. This consumes the ThinArc, so the refcount is not modified.

Trait Implementations

impl<T: ?Sized> AsRef<T> for Arc<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: ?Sized> Borrow<T> for Arc<T>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<T: ?Sized> Clone for Arc<T>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: ?Sized + Debug> Debug for Arc<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Default> Default for Arc<T>

fn default() -> Arc<T>

Returns the “default value” for a type.

impl<T: ?Sized> Deref for Arc<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: ?Sized + Display> Display for Arc<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: ?Sized> Drop for Arc<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: Copy> From<&[T]> for Arc<[T]>

fn from(slice: &[T]) -> Self

Converts to this type from the input type.

impl From<&str> for Arc<str>

fn from(s: &str) -> Self

Converts to this type from the input type.

impl<T: ?Sized> From<Arc<HeaderSlice<(), T>>> for Arc<T>

fn from(this: Arc<HeaderSlice<(), T>>) -> Self

Converts to this type from the input type.

impl<T: ?Sized> From<Arc<T>> for Arc<HeaderSlice<(), T>>

fn from(this: Arc<T>) -> Self

Converts to this type from the input type.

impl<T> From<Box<T>> for Arc<T>

fn from(b: Box<T>) -> Self

Converts to this type from the input type.

impl From<String> for Arc<str>

fn from(s: String) -> Self

Converts to this type from the input type.

impl<T> From<T> for Arc<T>

fn from(t: T) -> Self

Converts to this type from the input type.

impl<T> From<Vec<T>> for Arc<[T]>

fn from(v: Vec<T>) -> Self

Converts to this type from the input type.

impl<A> FromIterator<A> for Arc<[A]>

fn from_iter<T: IntoIterator<Item = A>>(iter: T) -> Self

Creates a value from an iterator.

impl<T: ?Sized + Hash> Hash for Arc<T>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: ?Sized + Ord> Ord for Arc<T>

fn cmp(&self, other: &Arc<T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl<T: ?Sized + PartialEq> PartialEq for Arc<T>

fn eq(&self, other: &Arc<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Arc<T>) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: ?Sized + PartialOrd> PartialOrd for Arc<T>

fn partial_cmp(&self, other: &Arc<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Arc<T>) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Arc<T>) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Arc<T>) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Arc<T>) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T: ?Sized> Pointer for Arc<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: ?Sized> TryFrom<Arc<T>> for UniqueArc<T>

type Error = Arc<T>

The type returned in the event of a conversion error.

fn try_from(arc: Arc<T>) -> Result<Self, Self::Error>

Performs the conversion.

impl<T: ?Sized + Eq> Eq for Arc<T>

impl<T: ?Sized + Sync + Send> Send for Arc<T>

impl<T: ?Sized + Sync + Send> Sync for Arc<T>