Struct rustc_trait_selection::infer::outlives::verify::VerifyBoundCx

pub struct VerifyBoundCx<'cx, 'tcx> {
    tcx: TyCtxt<'tcx>,
    region_bound_pairs: &'cx IndexSet<OutlivesPredicate<TyCtxt<'tcx>, GenericKind<'tcx>>, BuildHasherDefault<FxHasher>>,
    implicit_region_bound: Option<Region<'tcx>>,
    caller_bounds: &'cx [Binder<TyCtxt<'tcx>, OutlivesPredicate<TyCtxt<'tcx>, Ty<'tcx>>>],
}

The TypeOutlives struct has the job of “lowering” a T: 'a obligation into a series of 'a: 'b constraints and “verifys”, as described on the module comment. The final constraints are emitted via a “delegate” of type D – this is usually the infcx, which accrues them into the region_obligations code, but for NLL we use something else.

Fields

tcx: TyCtxt<'tcx>

region_bound_pairs: &'cx IndexSet<OutlivesPredicate<TyCtxt<'tcx>, GenericKind<'tcx>>, BuildHasherDefault<FxHasher>>

implicit_region_bound: Option<Region<'tcx>>

caller_bounds: &'cx [Binder<TyCtxt<'tcx>, OutlivesPredicate<TyCtxt<'tcx>, Ty<'tcx>>>]

Implementations

impl<'cx, 'tcx> VerifyBoundCx<'cx, 'tcx>

pub fn new( tcx: TyCtxt<'tcx>, region_bound_pairs: &'cx IndexSet<OutlivesPredicate<TyCtxt<'tcx>, GenericKind<'tcx>>, BuildHasherDefault<FxHasher>>, implicit_region_bound: Option<Region<'tcx>>, caller_bounds: &'cx [Binder<TyCtxt<'tcx>, OutlivesPredicate<TyCtxt<'tcx>, Ty<'tcx>>>], ) -> VerifyBoundCx<'cx, 'tcx>

pub fn param_or_placeholder_bound(&self, ty: Ty<'tcx>) -> VerifyBound<'tcx>

pub fn approx_declared_bounds_from_env( &self, alias_ty: AliasTy<TyCtxt<'tcx>>, ) -> Vec<Binder<TyCtxt<'tcx>, OutlivesPredicate<TyCtxt<'tcx>, Ty<'tcx>>>>

Given a projection like T::Item, searches the environment for where-clauses like T::Item: 'a. Returns the set of regions 'a that it finds.

This is an “approximate” check – it may not find all applicable bounds, and not all the bounds it returns can be relied upon. In particular, this check ignores region identity. So, for example, if we have <T as Trait<'0>>::Item where '0 is a region variable, and the user has <T as Trait<'a>>::Item: 'b in the environment, then the clause from the environment only applies if '0 = 'a, which we don’t know yet. But we would still include 'b in this list.

pub fn alias_bound(&self, alias_ty: AliasTy<TyCtxt<'tcx>>) -> VerifyBound<'tcx>

pub fn declared_bounds_from_definition( &self, alias_ty: AliasTy<TyCtxt<'tcx>>, ) -> impl Iterator<Item = Region<'tcx>>

Given a projection like <T as Foo<'x>>::Bar, returns any bounds declared in the trait definition. For example, if the trait were

trait Foo<'a> {
    type Bar: 'a;
}

If we were given the DefId of Foo::Bar, we would return 'a. You could then apply the instantiations from the projection to convert this into your namespace. This also works if the user writes where <Self as Foo<'a>>::Bar: 'a on the trait. In fact, it works by searching for just such a where-clause.

It will not, however, work for higher-ranked bounds like:

```ignore(this does compile today, previously was marked as compile_fail,E0311) trait Foo<’a, ’b> where for<’x> <Self as Foo<’x, ’b>>::Bar: ’x { type Bar; }

This is for simplicity, and because we are not really smart
enough to cope with such bounds anywhere.

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: 40 bytes