Creates a newUniqueArc.

Weak references to thisUniqueArc can be created withUniqueArc::downgrade. Upgradingthese weak references will fail before theUniqueArc has been converted into anArc.After converting theUniqueArc into anArc, any weak references created beforehand willpoint to the newArc.

Maps the value in aUniqueArc, reusing the allocation if possible.

f is called on a reference to the value in theUniqueArc, and the result is returned,also in aUniqueArc.

Note: this is an associated function, which means that you haveto call it asUniqueArc::map(u, f) instead ofu.map(f). Thisis so that there is no conflict with a method on the inner type.

§Examples

#![feature(smart_pointer_try_map)]#![feature(unique_rc_arc)]usestd::sync::UniqueArc;letr = UniqueArc::new(7);letnew = UniqueArc::map(r, |i| i +7);assert_eq!(*new,14);

Attempts to map the value in aUniqueArc, reusing the allocation if possible.

f is called on a reference to the value in theUniqueArc, and if the operation succeeds,the result is returned, also in aUniqueArc.

Note: this is an associated function, which means that you haveto call it asUniqueArc::try_map(u, f) instead ofu.try_map(f). Thisis so that there is no conflict with a method on the inner type.

§Examples

#![feature(smart_pointer_try_map)]#![feature(unique_rc_arc)]usestd::sync::UniqueArc;letb = UniqueArc::new(7);letnew = UniqueArc::try_map(b, u32::try_from).unwrap();assert_eq!(*new,7);

Creates a newUniqueArc in the provided allocator.

Weak references to thisUniqueArc can be created withUniqueArc::downgrade. Upgradingthese weak references will fail before theUniqueArc has been converted into anArc.After converting theUniqueArc into anArc, any weak references created beforehand willpoint to the newArc.

Converts theUniqueArc into a regularArc.

This consumes theUniqueArc and returns a regularArc that contains thevalue thatis passed tointo_arc.

Any weak references created before this method is called can now be upgraded to strongreferences.

Creates a new weak reference to theUniqueArc.

Attempting to upgrade this weak reference will fail before theUniqueArc has been convertedto aArc usingUniqueArc::into_arc.

Comparison for twoUniqueArcs.

The two are compared by callingcmp() on their inner values.

§Examples

#![feature(unique_rc_arc)]usestd::sync::UniqueArc;usestd::cmp::Ordering;letfive = UniqueArc::new(5);assert_eq!(Ordering::Less, five.cmp(&UniqueArc::new(6)));

Equality for twoUniqueArcs.

TwoUniqueArcs are equal if their inner values are equal.

§Examples

#![feature(unique_rc_arc)]usestd::sync::UniqueArc;letfive = UniqueArc::new(5);assert!(five == UniqueArc::new(5));

Partial comparison for twoUniqueArcs.

The two are compared by callingpartial_cmp() on their inner values.

§Examples

#![feature(unique_rc_arc)]usestd::sync::UniqueArc;usestd::cmp::Ordering;letfive = UniqueArc::new(5);assert_eq!(Some(Ordering::Less), five.partial_cmp(&UniqueArc::new(6)));

Less-than comparison for twoUniqueArcs.

The two are compared by calling< on their inner values.

§Examples

#![feature(unique_rc_arc)]usestd::sync::UniqueArc;letfive = UniqueArc::new(5);assert!(five < UniqueArc::new(6));

‘Less than or equal to’ comparison for twoUniqueArcs.

The two are compared by calling<= on their inner values.

§Examples

#![feature(unique_rc_arc)]usestd::sync::UniqueArc;letfive = UniqueArc::new(5);assert!(five <= UniqueArc::new(5));

Greater-than comparison for twoUniqueArcs.

The two are compared by calling> on their inner values.

§Examples

#![feature(unique_rc_arc)]usestd::sync::UniqueArc;letfive = UniqueArc::new(5);assert!(five > UniqueArc::new(4));

‘Greater than or equal to’ comparison for twoUniqueArcs.

The two are compared by calling>= on their inner values.

§Examples

#![feature(unique_rc_arc)]usestd::sync::UniqueArc;letfive = UniqueArc::new(5);assert!(five >= UniqueArc::new(5));

Returns the argument unchanged.

CallsU::from(self).

That is, this conversion is whatever the implementation ofFrom<T> for U chooses to do.