pub struct Region<'tcx>(pub Interned<'tcx, RegionKind<'tcx>>);
Expand description
Use this rather than RegionKind
, whenever possible.
Tuple Fields
0: Interned<'tcx, RegionKind<'tcx>>
Implementations
sourceimpl<'tcx> Region<'tcx>
impl<'tcx> Region<'tcx>
Region utilities
pub fn kind(self) -> RegionKind<'tcx>
pub fn is_static(self) -> bool
pub fn is_erased(self) -> bool
pub fn is_late_bound(self) -> bool
pub fn is_placeholder(self) -> bool
pub fn bound_at_or_above_binder(self, index: DebruijnIndex) -> bool
pub fn type_flags(self) -> TypeFlags
sourcepub fn free_region_binding_scope(self, tcx: TyCtxt<'_>) -> DefId
pub fn free_region_binding_scope(self, tcx: TyCtxt<'_>) -> DefId
Given an early-bound or free region, returns the DefId
where it was bound.
For example, consider the regions in this snippet of code:
ⓘ
impl<'a> Foo {
// ^^ -- early bound, declared on an impl
fn bar<'b, 'c>(x: &self, y: &'b u32, z: &'c u64) where 'static: 'c
// ^^ ^^ ^ anonymous, late-bound
// | early-bound, appears in where-clauses
// late-bound, appears only in fn args
{..}
}
Here, free_region_binding_scope('a)
would return the DefId
of the impl, and for all the other highlighted regions, it
would return the DefId
of the function. In other cases (not shown), this
function might return the DefId
of a closure.
sourcepub fn is_free_or_static(self) -> bool
pub fn is_free_or_static(self) -> bool
True if self
is a free region or static.
pub fn is_var(self) -> bool
Trait Implementations
sourceimpl<'tcx> Deref for Region<'tcx>
impl<'tcx> Deref for Region<'tcx>
type Target = RegionKind<TyCtxt<'tcx>>
type Target = RegionKind<TyCtxt<'tcx>>
The resulting type after dereferencing.
sourcefn deref(&self) -> &RegionKind<'tcx>
fn deref(&self) -> &RegionKind<'tcx>
Dereferences the value.
sourceimpl<'tcx> From<Region<'tcx>> for GenericArg<'tcx>
impl<'tcx> From<Region<'tcx>> for GenericArg<'tcx>
sourcefn from(r: Region<'tcx>) -> GenericArg<'tcx>
fn from(r: Region<'tcx>) -> GenericArg<'tcx>
Converts to this type from the input type.
sourceimpl<'tcx, '__ctx> HashStable<StableHashingContext<'__ctx>> for Region<'tcx>
impl<'tcx, '__ctx> HashStable<StableHashingContext<'__ctx>> for Region<'tcx>
fn hash_stable(
&self,
__hcx: &mut StableHashingContext<'__ctx>,
__hasher: &mut StableHasher
)
sourceimpl<'tcx> Ord for Region<'tcx>
impl<'tcx> Ord for Region<'tcx>
1.21.0 · sourcefn max(self, other: Self) -> Self
fn max(self, other: Self) -> Self
Compares and returns the maximum of two values. Read more
1.21.0 · sourcefn min(self, other: Self) -> Self
fn min(self, other: Self) -> Self
Compares and returns the minimum of two values. Read more
1.50.0 · sourcefn clamp(self, min: Self, max: Self) -> Selfwhere
Self: PartialOrd<Self>,
fn clamp(self, min: Self, max: Self) -> Selfwhere
Self: PartialOrd<Self>,
Restrict a value to a certain interval. Read more
sourceimpl<'tcx> PartialEq<Region<'tcx>> for Region<'tcx>
impl<'tcx> PartialEq<Region<'tcx>> for Region<'tcx>
sourceimpl<'tcx> PartialOrd<Region<'tcx>> for Region<'tcx>
impl<'tcx> PartialOrd<Region<'tcx>> for Region<'tcx>
sourcefn partial_cmp(&self, other: &Region<'tcx>) -> Option<Ordering>
fn partial_cmp(&self, other: &Region<'tcx>) -> Option<Ordering>
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for
self
and other
) and is used by the <=
operator. Read moresourceimpl<'tcx> Relate<'tcx> for Region<'tcx>
impl<'tcx> Relate<'tcx> for Region<'tcx>
fn relate<R: TypeRelation<'tcx>>(
relation: &mut R,
a: Region<'tcx>,
b: Region<'tcx>
) -> RelateResult<'tcx, Region<'tcx>>
sourceimpl<'tcx> TypeFoldable<'tcx> for Region<'tcx>
impl<'tcx> TypeFoldable<'tcx> for Region<'tcx>
sourcefn try_fold_with<F: FallibleTypeFolder<'tcx>>(
self,
folder: &mut F
) -> Result<Self, F::Error>
fn try_fold_with<F: FallibleTypeFolder<'tcx>>(
self,
folder: &mut F
) -> Result<Self, F::Error>
sourcefn fold_with<F: TypeFolder<'tcx>>(self, folder: &mut F) -> Self
fn fold_with<F: TypeFolder<'tcx>>(self, folder: &mut F) -> Self
A convenient alternative to
try_fold_with
for use with infallible
folders. Do not override this method, to ensure coherence with
try_fold_with
. Read moresourceimpl<'tcx> TypeSuperFoldable<'tcx> for Region<'tcx>
impl<'tcx> TypeSuperFoldable<'tcx> for Region<'tcx>
sourcefn try_super_fold_with<F: FallibleTypeFolder<'tcx>>(
self,
_folder: &mut F
) -> Result<Self, F::Error>
fn try_super_fold_with<F: FallibleTypeFolder<'tcx>>(
self,
_folder: &mut F
) -> Result<Self, F::Error>
Provides a default fold for a type of interest. This should only be
called within
TypeFolder
methods, when a non-custom traversal is
desired for the value of the type of interest passed to that method.
For example, in MyFolder::try_fold_ty(ty)
, it is valid to call
ty.try_super_fold_with(self)
, but any other folding should be done
with xyz.try_fold_with(self)
. Read moresourcefn super_fold_with<F: TypeFolder<'tcx>>(self, folder: &mut F) -> Self
fn super_fold_with<F: TypeFolder<'tcx>>(self, folder: &mut F) -> Self
A convenient alternative to
try_super_fold_with
for use with
infallible folders. Do not override this method, to ensure coherence
with try_super_fold_with
. Read moresourceimpl<'tcx> TypeSuperVisitable<'tcx> for Region<'tcx>
impl<'tcx> TypeSuperVisitable<'tcx> for Region<'tcx>
sourcefn super_visit_with<V: TypeVisitor<'tcx>>(
&self,
_visitor: &mut V
) -> ControlFlow<V::BreakTy>
fn super_visit_with<V: TypeVisitor<'tcx>>(
&self,
_visitor: &mut V
) -> ControlFlow<V::BreakTy>
Provides a default visit for a type of interest. This should only be
called within
TypeVisitor
methods, when a non-custom traversal is
desired for the value of the type of interest passed to that method.
For example, in MyVisitor::visit_ty(ty)
, it is valid to call
ty.super_visit_with(self)
, but any other visiting should be done
with xyz.visit_with(self)
. Read moresourceimpl<'tcx> TypeVisitable<'tcx> for Region<'tcx>
impl<'tcx> TypeVisitable<'tcx> for Region<'tcx>
sourcefn visit_with<V: TypeVisitor<'tcx>>(
&self,
visitor: &mut V
) -> ControlFlow<V::BreakTy>
fn visit_with<V: TypeVisitor<'tcx>>(
&self,
visitor: &mut V
) -> ControlFlow<V::BreakTy>
sourcefn has_vars_bound_at_or_above(&self, binder: DebruijnIndex) -> bool
fn has_vars_bound_at_or_above(&self, binder: DebruijnIndex) -> bool
Returns
true
if self
has any late-bound regions that are either
bound by binder
or bound by some binder outside of binder
.
If binder
is ty::INNERMOST
, this indicates whether
there are any late-bound regions that appear free. Read moresourcefn has_vars_bound_above(&self, binder: DebruijnIndex) -> bool
fn has_vars_bound_above(&self, binder: DebruijnIndex) -> bool
Returns
true
if this self
has any regions that escape binder
(and
hence are not bound by it). Read morefn has_escaping_bound_vars(&self) -> bool
fn has_type_flags(&self, flags: TypeFlags) -> bool
fn has_projections(&self) -> bool
fn has_opaque_types(&self) -> bool
fn references_error(&self) -> bool
fn error_reported(&self) -> Option<ErrorGuaranteed>
fn has_param_types_or_consts(&self) -> bool
fn has_infer_regions(&self) -> bool
fn has_infer_types(&self) -> bool
fn has_infer_types_or_consts(&self) -> bool
fn needs_infer(&self) -> bool
fn has_placeholders(&self) -> bool
fn needs_subst(&self) -> bool
sourcefn has_free_regions(&self) -> bool
fn has_free_regions(&self) -> bool
“Free” regions in this context means that it has any region
that is not (a) erased or (b) late-bound. Read more
fn has_erased_regions(&self) -> bool
sourcefn has_erasable_regions(&self) -> bool
fn has_erasable_regions(&self) -> bool
True if there are any un-erased free regions.
sourcefn is_global(&self) -> bool
fn is_global(&self) -> bool
Indicates whether this value references only ‘global’
generic parameters that are the same regardless of what fn we are
in. This is used for caching. Read more
sourcefn has_late_bound_regions(&self) -> bool
fn has_late_bound_regions(&self) -> bool
True if there are any late-bound regions
sourcefn still_further_specializable(&self) -> bool
fn still_further_specializable(&self) -> bool
Indicates whether this value still has parameters/placeholders/inference variables
which could be replaced later, in a way that would change the results of
impl
specialization. Read moreimpl<'tcx> Copy for Region<'tcx>
impl<'tcx> Eq for Region<'tcx>
impl<'tcx> StructuralEq for Region<'tcx>
impl<'tcx> StructuralPartialEq for Region<'tcx>
Auto Trait Implementations
impl<'tcx> RefUnwindSafe for Region<'tcx>
impl<'tcx> Send for Region<'tcx>
impl<'tcx> Sync for Region<'tcx>
impl<'tcx> Unpin for Region<'tcx>
impl<'tcx> UnwindSafe for Region<'tcx>
Blanket Implementations
sourceimpl<'tcx, T> ArenaAllocatable<'tcx, IsCopy> for Twhere
T: Copy,
impl<'tcx, T> ArenaAllocatable<'tcx, IsCopy> for Twhere
T: Copy,
fn allocate_on(self, arena: &'a Arena<'tcx>) -> &'a mut T
fn allocate_from_iter(
arena: &'a Arena<'tcx>,
iter: impl IntoIterator<Item = T>
) -> &'a mut [T]ⓘNotable traits for &[u8]impl Read for &[u8]impl Write for &mut [u8]
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<Ctxt, T> DepNodeParams<Ctxt> for Twhere
Ctxt: DepContext,
T: for<'a> HashStable<StableHashingContext<'a>> + Debug,
impl<Ctxt, T> DepNodeParams<Ctxt> for Twhere
Ctxt: DepContext,
T: for<'a> HashStable<StableHashingContext<'a>> + Debug,
default fn fingerprint_style() -> FingerprintStyle
sourcedefault fn to_fingerprint(&self, tcx: Ctxt) -> Fingerprint
default fn to_fingerprint(&self, tcx: Ctxt) -> Fingerprint
This method turns the parameters of a DepNodeConstructor into an opaque
Fingerprint to be used in DepNode.
Not all DepNodeParams support being turned into a Fingerprint (they
don’t need to if the corresponding DepNode is anonymous). Read more
default fn to_debug_str(&self, Ctxt) -> String
sourcedefault fn recover(Ctxt, &DepNode<<Ctxt as DepContext>::DepKind>) -> Option<T>
default fn recover(Ctxt, &DepNode<<Ctxt as DepContext>::DepKind>) -> Option<T>
This method tries to recover the query key from the given
DepNode
,
something which is needed when forcing DepNode
s during red-green
evaluation. The query system will only call this method if
fingerprint_style()
is not FingerprintStyle::Opaque
.
It is always valid to return None
here, in which case incremental
compilation will treat the query as having changed instead of forcing it. Read moresourceimpl<T, R> InternIteratorElement<T, R> for T
impl<T, R> InternIteratorElement<T, R> for T
type Output = R
fn intern_with<I, F>(iter: I, f: F) -> <T as InternIteratorElement<T, R>>::Outputwhere
I: Iterator<Item = T>,
F: FnOnce(&[T]) -> R,
sourceimpl<T> MaybeResult<T> for T
impl<T> MaybeResult<T> for T
sourceimpl<CTX, T> Value<CTX> for Twhere
CTX: DepContext,
impl<CTX, T> Value<CTX> for Twhere
CTX: DepContext,
default fn from_cycle_error(tcx: CTX) -> T
impl<'a, T> Captures<'a> for Twhere
T: ?Sized,
Layout
Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...)
attributes. Please see the Rust Reference’s “Type Layout” chapter for details on type layout guarantees.
Size: 8 bytes