1 //! Methods for normalizing when you don't care about regions (and
2 //! aren't doing type inference). If either of those things don't
3 //! apply to you, use `infcx.normalize(...)`.
5 //! The methods in this file use a `TypeFolder` to recursively process
6 //! contents, invoking the underlying
7 //! `normalize_generic_arg_after_erasing_regions` query for each type
8 //! or constant found within. (This underlying query is what is cached.)
11 use crate::ty::fold::{TypeFoldable, TypeFolder};
12 use crate::ty::subst::{Subst, SubstsRef};
13 use crate::ty::{self, Ty, TyCtxt};
15 impl<'tcx> TyCtxt<'tcx> {
16 /// Erase the regions in `value` and then fully normalize all the
17 /// types found within. The result will also have regions erased.
19 /// This is appropriate to use only after type-check: it assumes
20 /// that normalization will succeed, for example.
21 pub fn normalize_erasing_regions<T>(self, param_env: ty::ParamEnv<'tcx>, value: T) -> T
23 T: TypeFoldable<'tcx>,
26 "normalize_erasing_regions::<{}>(value={:?}, param_env={:?})",
27 std::any::type_name::<T>(),
32 // Erase first before we do the real query -- this keeps the
33 // cache from being too polluted.
34 let value = self.erase_regions(value);
35 if !value.has_projections() {
38 value.fold_with(&mut NormalizeAfterErasingRegionsFolder { tcx: self, param_env })
42 /// If you have a `Binder<'tcx, T>`, you can do this to strip out the
43 /// late-bound regions and then normalize the result, yielding up
44 /// a `T` (with regions erased). This is appropriate when the
45 /// binder is being instantiated at the call site.
47 /// N.B., currently, higher-ranked type bounds inhibit
48 /// normalization. Therefore, each time we erase them in
49 /// codegen, we need to normalize the contents.
50 pub fn normalize_erasing_late_bound_regions<T>(
52 param_env: ty::ParamEnv<'tcx>,
53 value: ty::Binder<'tcx, T>,
56 T: TypeFoldable<'tcx>,
58 let value = self.erase_late_bound_regions(value);
59 self.normalize_erasing_regions(param_env, value)
62 /// Monomorphizes a type from the AST by first applying the
63 /// in-scope substitutions and then normalizing any associated
65 pub fn subst_and_normalize_erasing_regions<T>(
67 param_substs: SubstsRef<'tcx>,
68 param_env: ty::ParamEnv<'tcx>,
72 T: TypeFoldable<'tcx>,
75 "subst_and_normalize_erasing_regions(\
79 param_substs, value, param_env,
81 let substituted = value.subst(self, param_substs);
82 self.normalize_erasing_regions(param_env, substituted)
86 struct NormalizeAfterErasingRegionsFolder<'tcx> {
88 param_env: ty::ParamEnv<'tcx>,
91 impl TypeFolder<'tcx> for NormalizeAfterErasingRegionsFolder<'tcx> {
92 fn tcx(&self) -> TyCtxt<'tcx> {
96 fn fold_ty(&mut self, ty: Ty<'tcx>) -> Ty<'tcx> {
97 let arg = self.param_env.and(ty.into());
98 self.tcx.normalize_generic_arg_after_erasing_regions(arg).expect_ty()
101 fn fold_const(&mut self, c: &'tcx ty::Const<'tcx>) -> &'tcx ty::Const<'tcx> {
102 let arg = self.param_env.and(c.into());
103 self.tcx.normalize_generic_arg_after_erasing_regions(arg).expect_const()
107 fn fold_mir_const(&mut self, c: mir::ConstantKind<'tcx>) -> mir::ConstantKind<'tcx> {
108 let arg = self.param_env.and(c);
109 self.tcx.normalize_mir_const_after_erasing_regions(arg)