Struct rustc_middle::ty::ParamEnv
source · pub struct ParamEnv<'tcx> {
packed: CopyTaggedPtr<&'tcx List<Clause<'tcx>>, ParamTag, true>,
}
Expand description
When type checking, we use the ParamEnv
to track
details about the set of where-clauses that are in scope at this
particular point.
Fields§
§packed: CopyTaggedPtr<&'tcx List<Clause<'tcx>>, ParamTag, true>
This packs both caller bounds and the reveal enum into one pointer.
Caller bounds are Obligation
s that the caller must satisfy. This is
basically the set of bounds on the in-scope type parameters, translated
into Obligation
s, and elaborated and normalized.
Use the caller_bounds()
method to access.
Typically, this is Reveal::UserFacing
, but during codegen we
want Reveal::All
.
Note: This is packed, use the reveal() method to access it.
Implementations§
source§impl<'tcx> ParamEnv<'tcx>
impl<'tcx> ParamEnv<'tcx>
sourcepub fn empty() -> Self
pub fn empty() -> Self
Construct a trait environment suitable for contexts where
there are no where-clauses in scope. Hidden types (like impl Trait
) are left hidden, so this is suitable for ordinary
type-checking.
pub fn caller_bounds(self) -> &'tcx List<Clause<'tcx>>
pub fn reveal(self) -> Reveal
sourcepub fn reveal_all() -> Self
pub fn reveal_all() -> Self
Construct a trait environment with no where-clauses in scope
where the values of all impl Trait
and other hidden types
are revealed. This is suitable for monomorphized, post-typeck
environments like codegen or doing optimizations.
N.B., if you want to have predicates in scope, use ParamEnv::new
,
or invoke param_env.with_reveal_all()
.
sourcepub fn new(caller_bounds: &'tcx List<Clause<'tcx>>, reveal: Reveal) -> Self
pub fn new(caller_bounds: &'tcx List<Clause<'tcx>>, reveal: Reveal) -> Self
Construct a trait environment with the given set of predicates.
pub fn with_user_facing(self) -> Self
sourcepub fn with_reveal_all_normalized(self, tcx: TyCtxt<'tcx>) -> Self
pub fn with_reveal_all_normalized(self, tcx: TyCtxt<'tcx>) -> Self
Returns a new parameter environment with the same clauses, but
which “reveals” the true results of projections in all cases
(even for associated types that are specializable). This is
the desired behavior during codegen and certain other special
contexts; normally though we want to use Reveal::UserFacing
,
which is the default.
All opaque types in the caller_bounds of the ParamEnv
will be normalized to their underlying types.
See PR #65989 and issue #65918 for more details
sourcepub fn without_caller_bounds(self) -> Self
pub fn without_caller_bounds(self) -> Self
Returns this same environment but with no caller bounds.
sourcepub fn and<T: TypeVisitable<TyCtxt<'tcx>>>(
self,
value: T
) -> ParamEnvAnd<'tcx, T>
pub fn and<T: TypeVisitable<TyCtxt<'tcx>>>( self, value: T ) -> ParamEnvAnd<'tcx, T>
Creates a pair of param-env and value for use in queries.
Trait Implementations§
source§impl<'a, 'tcx> HashStable<StableHashingContext<'a>> for ParamEnv<'tcx>
impl<'a, 'tcx> HashStable<StableHashingContext<'a>> for ParamEnv<'tcx>
fn hash_stable( &self, hcx: &mut StableHashingContext<'a>, hasher: &mut StableHasher )
source§impl<'tcx> Key for ParamEnv<'tcx>
impl<'tcx> Key for ParamEnv<'tcx>
type CacheSelector = DefaultCacheSelector<ParamEnv<'tcx>>
source§fn default_span(&self, _: TyCtxt<'_>) -> Span
fn default_span(&self, _: TyCtxt<'_>) -> Span
self
, what span should we use?source§fn key_as_def_id(&self) -> Option<DefId>
fn key_as_def_id(&self) -> Option<DefId>
fn ty_adt_id(&self) -> Option<DefId>
source§impl<'tcx> PartialEq<ParamEnv<'tcx>> for ParamEnv<'tcx>
impl<'tcx> PartialEq<ParamEnv<'tcx>> for ParamEnv<'tcx>
source§impl<'tcx> TypeFoldable<TyCtxt<'tcx>> for ParamEnv<'tcx>
impl<'tcx> TypeFoldable<TyCtxt<'tcx>> for ParamEnv<'tcx>
source§fn try_fold_with<F: FallibleTypeFolder<TyCtxt<'tcx>>>(
self,
folder: &mut F
) -> Result<Self, F::Error>
fn try_fold_with<F: FallibleTypeFolder<TyCtxt<'tcx>>>( self, folder: &mut F ) -> Result<Self, F::Error>
source§fn fold_with<F>(self, folder: &mut F) -> Selfwhere
F: TypeFolder<I>,
fn fold_with<F>(self, folder: &mut F) -> Selfwhere F: TypeFolder<I>,
try_fold_with
for use with infallible
folders. Do not override this method, to ensure coherence with
try_fold_with
.source§impl<'tcx> TypeVisitable<TyCtxt<'tcx>> for ParamEnv<'tcx>
impl<'tcx> TypeVisitable<TyCtxt<'tcx>> for ParamEnv<'tcx>
source§fn visit_with<V: TypeVisitor<TyCtxt<'tcx>>>(
&self,
visitor: &mut V
) -> ControlFlow<V::BreakTy>
fn visit_with<V: TypeVisitor<TyCtxt<'tcx>>>( &self, visitor: &mut V ) -> ControlFlow<V::BreakTy>
impl<'tcx> Copy for ParamEnv<'tcx>
impl<'tcx> Eq for ParamEnv<'tcx>
impl<'tcx> StructuralEq for ParamEnv<'tcx>
impl<'tcx> StructuralPartialEq for ParamEnv<'tcx>
Auto Trait Implementations§
impl<'tcx> !RefUnwindSafe for ParamEnv<'tcx>
impl<'tcx> Send for ParamEnv<'tcx>
impl<'tcx> Sync for ParamEnv<'tcx>
impl<'tcx> Unpin for ParamEnv<'tcx>
impl<'tcx> !UnwindSafe for ParamEnv<'tcx>
Blanket Implementations§
source§impl<'tcx, T> ArenaAllocatable<'tcx, IsCopy> for Twhere
T: Copy,
impl<'tcx, T> ArenaAllocatable<'tcx, IsCopy> for Twhere T: Copy,
fn allocate_on<'a>(self, arena: &'a Arena<'tcx>) -> &'a mut T
fn allocate_from_iter<'a>( arena: &'a Arena<'tcx>, iter: impl IntoIterator<Item = T> ) -> &'a mut [T]
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, R> CollectAndApply<T, R> for T
impl<T, R> CollectAndApply<T, R> for T
source§impl<Tcx, T> DepNodeParams<Tcx> for Twhere
Tcx: DepContext,
T: for<'a> HashStable<StableHashingContext<'a>> + Debug,
impl<Tcx, T> DepNodeParams<Tcx> for Twhere Tcx: DepContext, T: for<'a> HashStable<StableHashingContext<'a>> + Debug,
default fn fingerprint_style() -> FingerprintStyle
source§default fn to_fingerprint(&self, tcx: Tcx) -> Fingerprint
default fn to_fingerprint(&self, tcx: Tcx) -> Fingerprint
default fn to_debug_str(&self, _: Tcx) -> String
source§default fn recover(_: Tcx, _: &DepNode) -> Option<T>
default fn recover(_: Tcx, _: &DepNode) -> Option<T>
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.source§impl<P> IntoQueryParam<P> for P
impl<P> IntoQueryParam<P> for P
fn into_query_param(self) -> P
source§impl<'tcx, T> IsSuggestable<'tcx> for Twhere
T: TypeVisitable<TyCtxt<'tcx>> + TypeFoldable<TyCtxt<'tcx>>,
impl<'tcx, T> IsSuggestable<'tcx> for Twhere T: TypeVisitable<TyCtxt<'tcx>> + TypeFoldable<TyCtxt<'tcx>>,
source§impl<T> MaybeResult<T> for T
impl<T> MaybeResult<T> for T
source§impl<'tcx, T> ToPredicate<'tcx, T> for T
impl<'tcx, T> ToPredicate<'tcx, T> for T
fn to_predicate(self, _tcx: TyCtxt<'tcx>) -> T
source§impl<'tcx, T> TypeVisitableExt<'tcx> for Twhere
T: TypeVisitable<TyCtxt<'tcx>>,
impl<'tcx, T> TypeVisitableExt<'tcx> for Twhere T: TypeVisitable<TyCtxt<'tcx>>,
source§fn has_vars_bound_at_or_above(&self, binder: DebruijnIndex) -> bool
fn has_vars_bound_at_or_above(&self, binder: DebruijnIndex) -> bool
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.source§fn has_vars_bound_above(&self, binder: DebruijnIndex) -> bool
fn has_vars_bound_above(&self, binder: DebruijnIndex) -> bool
true
if this type has any regions that escape binder
(and
hence are not bound by it).source§fn has_escaping_bound_vars(&self) -> bool
fn has_escaping_bound_vars(&self) -> bool
true
if this type has regions that are not a part of the type.
For example, for<'a> fn(&'a i32)
return false
, while fn(&'a i32)
would return true
. The latter can occur when traversing through the
former. Read morefn has_type_flags(&self, flags: TypeFlags) -> bool
fn has_projections(&self) -> bool
fn has_inherent_projections(&self) -> bool
fn has_opaque_types(&self) -> bool
fn has_generators(&self) -> bool
fn references_error(&self) -> bool
fn error_reported(&self) -> Result<(), ErrorGuaranteed>
fn has_non_region_param(&self) -> bool
fn has_infer_regions(&self) -> bool
fn has_infer_types(&self) -> bool
fn has_non_region_infer(&self) -> bool
fn has_infer(&self) -> bool
fn has_placeholders(&self) -> bool
fn has_non_region_placeholders(&self) -> bool
fn has_param(&self) -> bool
source§fn has_free_regions(&self) -> bool
fn has_free_regions(&self) -> bool
fn has_erased_regions(&self) -> bool
source§fn has_erasable_regions(&self) -> bool
fn has_erasable_regions(&self) -> bool
source§fn is_global(&self) -> bool
fn is_global(&self) -> bool
source§fn has_late_bound_regions(&self) -> bool
fn has_late_bound_regions(&self) -> bool
source§fn has_non_region_late_bound(&self) -> bool
fn has_non_region_late_bound(&self) -> bool
source§fn has_late_bound_vars(&self) -> bool
fn has_late_bound_vars(&self) -> bool
source§fn still_further_specializable(&self) -> bool
fn still_further_specializable(&self) -> bool
impl
specialization.source§impl<Tcx, T> Value<Tcx> for Twhere
Tcx: DepContext,
impl<Tcx, T> Value<Tcx> for Twhere Tcx: DepContext,
default fn from_cycle_error( tcx: Tcx, cycle: &[QueryInfo], _guar: ErrorGuaranteed ) -> T
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