Struct jumpy::core::physics::rapier::CollisionEventFlags
pub struct CollisionEventFlags {
bits: u32,
}
Expand description
Flags providing more information regarding a collision event.
Fields§
§bits: u32
Implementations§
§impl CollisionEventFlags
impl CollisionEventFlags
pub const SENSOR: CollisionEventFlags = _
pub const SENSOR: CollisionEventFlags = _
Flag set if at least one of the colliders involved in the collision was a sensor when the event was fired.
pub const REMOVED: CollisionEventFlags = _
pub const REMOVED: CollisionEventFlags = _
Flag set if a CollisionEvent::Stopped
was fired because
at least one of the colliders was removed.
pub const fn empty() -> CollisionEventFlags
pub const fn empty() -> CollisionEventFlags
Returns an empty set of flags.
pub const fn all() -> CollisionEventFlags
pub const fn all() -> CollisionEventFlags
Returns the set containing all flags.
pub const fn from_bits(bits: u32) -> Option<CollisionEventFlags>
pub const fn from_bits(bits: u32) -> Option<CollisionEventFlags>
Convert from underlying bit representation, unless that representation contains bits that do not correspond to a flag.
pub const fn from_bits_truncate(bits: u32) -> CollisionEventFlags
pub const fn from_bits_truncate(bits: u32) -> CollisionEventFlags
Convert from underlying bit representation, dropping any bits that do not correspond to flags.
pub const unsafe fn from_bits_unchecked(bits: u32) -> CollisionEventFlags
pub const unsafe fn from_bits_unchecked(bits: u32) -> CollisionEventFlags
Convert from underlying bit representation, preserving all bits (even those not corresponding to a defined flag).
§Safety
The caller of the bitflags!
macro can chose to allow or
disallow extra bits for their bitflags type.
The caller of from_bits_unchecked()
has to ensure that
all bits correspond to a defined flag or that extra bits
are valid for this bitflags type.
pub const fn intersects(&self, other: CollisionEventFlags) -> bool
pub const fn intersects(&self, other: CollisionEventFlags) -> bool
Returns true
if there are flags common to both self
and other
.
pub const fn contains(&self, other: CollisionEventFlags) -> bool
pub const fn contains(&self, other: CollisionEventFlags) -> bool
Returns true
if all of the flags in other
are contained within self
.
pub fn insert(&mut self, other: CollisionEventFlags)
pub fn insert(&mut self, other: CollisionEventFlags)
Inserts the specified flags in-place.
pub fn remove(&mut self, other: CollisionEventFlags)
pub fn remove(&mut self, other: CollisionEventFlags)
Removes the specified flags in-place.
pub fn toggle(&mut self, other: CollisionEventFlags)
pub fn toggle(&mut self, other: CollisionEventFlags)
Toggles the specified flags in-place.
pub fn set(&mut self, other: CollisionEventFlags, value: bool)
pub fn set(&mut self, other: CollisionEventFlags, value: bool)
Inserts or removes the specified flags depending on the passed value.
pub const fn intersection(
self,
other: CollisionEventFlags,
) -> CollisionEventFlags
pub const fn intersection( self, other: CollisionEventFlags, ) -> CollisionEventFlags
Returns the intersection between the flags in self
and
other
.
Specifically, the returned set contains only the flags which are
present in both self
and other
.
This is equivalent to using the &
operator (e.g.
ops::BitAnd
), as in flags & other
.
pub const fn union(self, other: CollisionEventFlags) -> CollisionEventFlags
pub const fn union(self, other: CollisionEventFlags) -> CollisionEventFlags
Returns the union of between the flags in self
and other
.
Specifically, the returned set contains all flags which are
present in either self
or other
, including any which are
present in both (see Self::symmetric_difference
if that
is undesirable).
This is equivalent to using the |
operator (e.g.
ops::BitOr
), as in flags | other
.
pub const fn difference(self, other: CollisionEventFlags) -> CollisionEventFlags
pub const fn difference(self, other: CollisionEventFlags) -> CollisionEventFlags
Returns the difference between the flags in self
and other
.
Specifically, the returned set contains all flags present in
self
, except for the ones present in other
.
It is also conceptually equivalent to the “bit-clear” operation:
flags & !other
(and this syntax is also supported).
This is equivalent to using the -
operator (e.g.
ops::Sub
), as in flags - other
.
pub const fn symmetric_difference(
self,
other: CollisionEventFlags,
) -> CollisionEventFlags
pub const fn symmetric_difference( self, other: CollisionEventFlags, ) -> CollisionEventFlags
Returns the symmetric difference between the flags
in self
and other
.
Specifically, the returned set contains the flags present which
are present in self
or other
, but that are not present in
both. Equivalently, it contains the flags present in exactly
one of the sets self
and other
.
This is equivalent to using the ^
operator (e.g.
ops::BitXor
), as in flags ^ other
.
pub const fn complement(self) -> CollisionEventFlags
pub const fn complement(self) -> CollisionEventFlags
Returns the complement of this set of flags.
Specifically, the returned set contains all the flags which are
not set in self
, but which are allowed for this type.
Alternatively, it can be thought of as the set difference
between Self::all()
and self
(e.g. Self::all() - self
)
This is equivalent to using the !
operator (e.g.
ops::Not
), as in !flags
.
Trait Implementations§
§impl Binary for CollisionEventFlags
impl Binary for CollisionEventFlags
§impl BitAnd for CollisionEventFlags
impl BitAnd for CollisionEventFlags
§fn bitand(self, other: CollisionEventFlags) -> CollisionEventFlags
fn bitand(self, other: CollisionEventFlags) -> CollisionEventFlags
Returns the intersection between the two sets of flags.
§type Output = CollisionEventFlags
type Output = CollisionEventFlags
&
operator.§impl BitAndAssign for CollisionEventFlags
impl BitAndAssign for CollisionEventFlags
§fn bitand_assign(&mut self, other: CollisionEventFlags)
fn bitand_assign(&mut self, other: CollisionEventFlags)
Disables all flags disabled in the set.
§impl BitOr for CollisionEventFlags
impl BitOr for CollisionEventFlags
§fn bitor(self, other: CollisionEventFlags) -> CollisionEventFlags
fn bitor(self, other: CollisionEventFlags) -> CollisionEventFlags
Returns the union of the two sets of flags.
§type Output = CollisionEventFlags
type Output = CollisionEventFlags
|
operator.§impl BitOrAssign for CollisionEventFlags
impl BitOrAssign for CollisionEventFlags
§fn bitor_assign(&mut self, other: CollisionEventFlags)
fn bitor_assign(&mut self, other: CollisionEventFlags)
Adds the set of flags.
§impl BitXor for CollisionEventFlags
impl BitXor for CollisionEventFlags
§fn bitxor(self, other: CollisionEventFlags) -> CollisionEventFlags
fn bitxor(self, other: CollisionEventFlags) -> CollisionEventFlags
Returns the left flags, but with all the right flags toggled.
§type Output = CollisionEventFlags
type Output = CollisionEventFlags
^
operator.§impl BitXorAssign for CollisionEventFlags
impl BitXorAssign for CollisionEventFlags
§fn bitxor_assign(&mut self, other: CollisionEventFlags)
fn bitxor_assign(&mut self, other: CollisionEventFlags)
Toggles the set of flags.
§impl Clone for CollisionEventFlags
impl Clone for CollisionEventFlags
§fn clone(&self) -> CollisionEventFlags
fn clone(&self) -> CollisionEventFlags
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more§impl Debug for CollisionEventFlags
impl Debug for CollisionEventFlags
§impl Extend<CollisionEventFlags> for CollisionEventFlags
impl Extend<CollisionEventFlags> for CollisionEventFlags
§fn extend<T>(&mut self, iterator: T)where
T: IntoIterator<Item = CollisionEventFlags>,
fn extend<T>(&mut self, iterator: T)where
T: IntoIterator<Item = CollisionEventFlags>,
source§fn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)source§fn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)§impl FromIterator<CollisionEventFlags> for CollisionEventFlags
impl FromIterator<CollisionEventFlags> for CollisionEventFlags
§fn from_iter<T>(iterator: T) -> CollisionEventFlagswhere
T: IntoIterator<Item = CollisionEventFlags>,
fn from_iter<T>(iterator: T) -> CollisionEventFlagswhere
T: IntoIterator<Item = CollisionEventFlags>,
§impl Hash for CollisionEventFlags
impl Hash for CollisionEventFlags
§impl LowerHex for CollisionEventFlags
impl LowerHex for CollisionEventFlags
§impl Not for CollisionEventFlags
impl Not for CollisionEventFlags
§fn not(self) -> CollisionEventFlags
fn not(self) -> CollisionEventFlags
Returns the complement of this set of flags.
§type Output = CollisionEventFlags
type Output = CollisionEventFlags
!
operator.§impl Octal for CollisionEventFlags
impl Octal for CollisionEventFlags
§impl Ord for CollisionEventFlags
impl Ord for CollisionEventFlags
§fn cmp(&self, other: &CollisionEventFlags) -> Ordering
fn cmp(&self, other: &CollisionEventFlags) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
§impl PartialEq for CollisionEventFlags
impl PartialEq for CollisionEventFlags
§fn eq(&self, other: &CollisionEventFlags) -> bool
fn eq(&self, other: &CollisionEventFlags) -> bool
self
and other
values to be equal, and is used
by ==
.§impl PartialOrd for CollisionEventFlags
impl PartialOrd for CollisionEventFlags
§fn partial_cmp(&self, other: &CollisionEventFlags) -> Option<Ordering>
fn partial_cmp(&self, other: &CollisionEventFlags) -> Option<Ordering>
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§impl Sub for CollisionEventFlags
impl Sub for CollisionEventFlags
§fn sub(self, other: CollisionEventFlags) -> CollisionEventFlags
fn sub(self, other: CollisionEventFlags) -> CollisionEventFlags
Returns the set difference of the two sets of flags.
§type Output = CollisionEventFlags
type Output = CollisionEventFlags
-
operator.§impl SubAssign for CollisionEventFlags
impl SubAssign for CollisionEventFlags
§fn sub_assign(&mut self, other: CollisionEventFlags)
fn sub_assign(&mut self, other: CollisionEventFlags)
Disables all flags enabled in the set.
§impl UpperHex for CollisionEventFlags
impl UpperHex for CollisionEventFlags
impl Copy for CollisionEventFlags
impl Eq for CollisionEventFlags
impl StructuralPartialEq for CollisionEventFlags
Auto Trait Implementations§
impl Freeze for CollisionEventFlags
impl RefUnwindSafe for CollisionEventFlags
impl Send for CollisionEventFlags
impl Sync for CollisionEventFlags
impl Unpin for CollisionEventFlags
impl UnwindSafe for CollisionEventFlags
Blanket Implementations§
§impl<T, U> AsBindGroupShaderType<U> for T
impl<T, U> AsBindGroupShaderType<U> for T
§fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U
fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U
T
[ShaderType
] for self
. When used in [AsBindGroup
]
derives, it is safe to assume that all images in self
exist.§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
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
source§impl<T> CloneToUninit for Twhere
T: Copy,
impl<T> CloneToUninit for Twhere
T: Copy,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.§impl<T> DowncastSync for T
impl<T> DowncastSync for T
§impl<T> DynEq for T
impl<T> DynEq for T
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
fn equivalent(&self, key: &K) -> bool
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<S> FromSample<S> for S
impl<S> FromSample<S> for S
fn from_sample_(s: S) -> S
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more§impl<F, T> IntoSample<T> for Fwhere
T: FromSample<F>,
impl<F, T> IntoSample<T> for Fwhere
T: FromSample<F>,
fn into_sample(self) -> T
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read more§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.