Enum bevy_utils::CowArc
source · pub enum CowArc<'a, T: ?Sized + 'static> {
Borrowed(&'a T),
Static(&'static T),
Owned(Arc<T>),
}
Expand description
Much like a Cow
, but owned values are Arc-ed to make clones cheap. This should be used for values that
are cloned for use across threads and change rarely (if ever).
This also makes an opinionated tradeoff by adding a CowArc::Static
and implementing [From<&'static T>
] instead of
[From<'a T>
]. This preserves the static context and prevents conversion to CowArc::Owned
in cases where a reference
is known to be static. This is an optimization that prevents allocations and atomic ref-counting.
This means that static references should prefer From::from
or CowArc::Static
and non-static references must
use CowArc::Borrowed
.
Variants§
Borrowed(&'a T)
A borrowed value
Static(&'static T)
A static value reference. This exists to avoid conversion to CowArc::Owned
in cases where a reference is
known to be static. This is an optimization that prevents allocations and atomic ref-counting.
Owned(Arc<T>)
An owned Arc
-ed value
Implementations§
source§impl<'a, T: ?Sized> CowArc<'a, T>
impl<'a, T: ?Sized> CowArc<'a, T>
sourcepub fn into_owned(self) -> CowArc<'static, T>
pub fn into_owned(self) -> CowArc<'static, T>
Converts this into an “owned” value. If internally a value is borrowed, it will be cloned into an “owned Arc
”.
If it is already a CowArc::Owned
or a CowArc::Static
, it will remain unchanged.
sourcepub fn clone_owned(&self) -> CowArc<'static, T>
pub fn clone_owned(&self) -> CowArc<'static, T>
Clones into an owned [CowArc<'static>
]. If internally a value is borrowed, it will be cloned into an “owned Arc
”.
If it is already a CowArc::Owned
or CowArc::Static
, the value will be cloned.
This is equivalent to .clone().into_owned()
.
Trait Implementations§
source§impl<T: ?Sized> From<&'static T> for CowArc<'static, T>
impl<T: ?Sized> From<&'static T> for CowArc<'static, T>
source§fn from(value: &'static T) -> Self
fn from(value: &'static T) -> Self
source§impl<'a, T: Ord + ?Sized> Ord for CowArc<'a, T>
impl<'a, T: Ord + ?Sized> Ord for CowArc<'a, T>
source§impl<'a, T: PartialEq + ?Sized> PartialEq for CowArc<'a, T>
impl<'a, T: PartialEq + ?Sized> PartialEq for CowArc<'a, T>
source§impl<'a, T: PartialOrd + ?Sized> PartialOrd for CowArc<'a, T>
impl<'a, T: PartialOrd + ?Sized> PartialOrd for CowArc<'a, T>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read more