rustc_borrowck/type_check/
canonical.rs

1use std::fmt;
2
3use rustc_errors::ErrorGuaranteed;
4use rustc_infer::infer::canonical::Canonical;
5use rustc_infer::infer::outlives::env::RegionBoundPairs;
6use rustc_middle::bug;
7use rustc_middle::mir::{Body, ConstraintCategory};
8use rustc_middle::ty::{self, Ty, TyCtxt, TypeFoldable, Upcast};
9use rustc_span::Span;
10use rustc_span::def_id::DefId;
11use rustc_trait_selection::solve::NoSolution;
12use rustc_trait_selection::traits::ObligationCause;
13use rustc_trait_selection::traits::query::type_op::custom::CustomTypeOp;
14use rustc_trait_selection::traits::query::type_op::{self, TypeOpOutput};
15use tracing::{debug, instrument};
16
17use super::{Locations, NormalizeLocation, TypeChecker};
18use crate::BorrowckInferCtxt;
19use crate::diagnostics::ToUniverseInfo;
20use crate::type_check::{MirTypeckRegionConstraints, constraint_conversion};
21use crate::universal_regions::UniversalRegions;
22
23#[instrument(skip(infcx, constraints, op), level = "trace")]
24pub(crate) fn fully_perform_op_raw<'tcx, R: fmt::Debug, Op>(
25    infcx: &BorrowckInferCtxt<'tcx>,
26    body: &Body<'tcx>,
27    universal_regions: &UniversalRegions<'tcx>,
28    region_bound_pairs: &RegionBoundPairs<'tcx>,
29    known_type_outlives_obligations: &[ty::PolyTypeOutlivesPredicate<'tcx>],
30    constraints: &mut MirTypeckRegionConstraints<'tcx>,
31    locations: Locations,
32    category: ConstraintCategory<'tcx>,
33    op: Op,
34) -> Result<R, ErrorGuaranteed>
35where
36    Op: type_op::TypeOp<'tcx, Output = R>,
37    Op::ErrorInfo: ToUniverseInfo<'tcx>,
38{
39    let old_universe = infcx.universe();
40
41    let TypeOpOutput { output, constraints: query_constraints, error_info } =
42        op.fully_perform(infcx, infcx.root_def_id, locations.span(body))?;
43    if cfg!(debug_assertions) {
44        let data = infcx.take_and_reset_region_constraints();
45        if !data.is_empty() {
46            panic!("leftover region constraints: {data:#?}");
47        }
48    }
49
50    debug!(?output, ?query_constraints);
51
52    if let Some(data) = query_constraints {
53        constraint_conversion::ConstraintConversion::new(
54            infcx,
55            universal_regions,
56            region_bound_pairs,
57            known_type_outlives_obligations,
58            locations,
59            locations.span(body),
60            category,
61            constraints,
62        )
63        .convert_all(data);
64    }
65
66    // If the query has created new universes and errors are going to be emitted, register the
67    // cause of these new universes for improved diagnostics.
68    let universe = infcx.universe();
69    if old_universe != universe
70        && let Some(error_info) = error_info
71    {
72        let universe_info = error_info.to_universe_info(old_universe);
73        for u in (old_universe + 1)..=universe {
74            constraints.universe_causes.insert(u, universe_info.clone());
75        }
76    }
77
78    Ok(output)
79}
80
81impl<'a, 'tcx> TypeChecker<'a, 'tcx> {
82    /// Given some operation `op` that manipulates types, proves
83    /// predicates, or otherwise uses the inference context, executes
84    /// `op` and then executes all the further obligations that `op`
85    /// returns. This will yield a set of outlives constraints amongst
86    /// regions which are extracted and stored as having occurred at
87    /// `locations`.
88    ///
89    /// **Any `rustc_infer::infer` operations that might generate region
90    /// constraints should occur within this method so that those
91    /// constraints can be properly localized!**
92    #[instrument(skip(self, op), level = "trace")]
93    pub(super) fn fully_perform_op<R: fmt::Debug, Op>(
94        &mut self,
95        locations: Locations,
96        category: ConstraintCategory<'tcx>,
97        op: Op,
98    ) -> Result<R, ErrorGuaranteed>
99    where
100        Op: type_op::TypeOp<'tcx, Output = R>,
101        Op::ErrorInfo: ToUniverseInfo<'tcx>,
102    {
103        fully_perform_op_raw(
104            self.infcx,
105            self.body,
106            self.universal_regions,
107            self.region_bound_pairs,
108            self.known_type_outlives_obligations,
109            self.constraints,
110            locations,
111            category,
112            op,
113        )
114    }
115
116    pub(super) fn instantiate_canonical<T>(
117        &mut self,
118        span: Span,
119        canonical: &Canonical<'tcx, T>,
120    ) -> T
121    where
122        T: TypeFoldable<TyCtxt<'tcx>>,
123    {
124        let (instantiated, _) = self.infcx.instantiate_canonical(span, canonical);
125        instantiated
126    }
127
128    #[instrument(skip(self), level = "debug")]
129    pub(super) fn prove_trait_ref(
130        &mut self,
131        trait_ref: ty::TraitRef<'tcx>,
132        locations: Locations,
133        category: ConstraintCategory<'tcx>,
134    ) {
135        self.prove_predicate(
136            ty::Binder::dummy(ty::PredicateKind::Clause(ty::ClauseKind::Trait(
137                ty::TraitPredicate { trait_ref, polarity: ty::PredicatePolarity::Positive },
138            ))),
139            locations,
140            category,
141        );
142    }
143
144    #[instrument(level = "debug", skip(self))]
145    pub(super) fn normalize_and_prove_instantiated_predicates(
146        &mut self,
147        // Keep this parameter for now, in case we start using
148        // it in `ConstraintCategory` at some point.
149        _def_id: DefId,
150        instantiated_predicates: ty::InstantiatedPredicates<'tcx>,
151        locations: Locations,
152    ) {
153        for (predicate, span) in instantiated_predicates {
154            debug!(?span, ?predicate);
155            let category = ConstraintCategory::Predicate(span);
156            let predicate = self.normalize_with_category(predicate, locations, category);
157            self.prove_predicate(predicate, locations, category);
158        }
159    }
160
161    pub(super) fn prove_predicates(
162        &mut self,
163        predicates: impl IntoIterator<Item: Upcast<TyCtxt<'tcx>, ty::Predicate<'tcx>> + std::fmt::Debug>,
164        locations: Locations,
165        category: ConstraintCategory<'tcx>,
166    ) {
167        for predicate in predicates {
168            self.prove_predicate(predicate, locations, category);
169        }
170    }
171
172    #[instrument(skip(self), level = "debug")]
173    pub(super) fn prove_predicate(
174        &mut self,
175        predicate: impl Upcast<TyCtxt<'tcx>, ty::Predicate<'tcx>> + std::fmt::Debug,
176        locations: Locations,
177        category: ConstraintCategory<'tcx>,
178    ) {
179        let param_env = self.infcx.param_env;
180        let predicate = predicate.upcast(self.tcx());
181        let _: Result<_, ErrorGuaranteed> = self.fully_perform_op(
182            locations,
183            category,
184            param_env.and(type_op::prove_predicate::ProvePredicate { predicate }),
185        );
186    }
187
188    pub(super) fn normalize<T>(&mut self, value: T, location: impl NormalizeLocation) -> T
189    where
190        T: type_op::normalize::Normalizable<'tcx> + fmt::Display + Copy + 'tcx,
191    {
192        self.normalize_with_category(value, location, ConstraintCategory::Boring)
193    }
194
195    pub(super) fn deeply_normalize<T>(&mut self, value: T, location: impl NormalizeLocation) -> T
196    where
197        T: type_op::normalize::Normalizable<'tcx> + fmt::Display + Copy + 'tcx,
198    {
199        let result: Result<_, ErrorGuaranteed> = self.fully_perform_op(
200            location.to_locations(),
201            ConstraintCategory::Boring,
202            self.infcx.param_env.and(type_op::normalize::DeeplyNormalize { value }),
203        );
204        result.unwrap_or(value)
205    }
206
207    #[instrument(skip(self), level = "debug")]
208    pub(super) fn normalize_with_category<T>(
209        &mut self,
210        value: T,
211        location: impl NormalizeLocation,
212        category: ConstraintCategory<'tcx>,
213    ) -> T
214    where
215        T: type_op::normalize::Normalizable<'tcx> + fmt::Display + Copy + 'tcx,
216    {
217        let param_env = self.infcx.param_env;
218        let result: Result<_, ErrorGuaranteed> = self.fully_perform_op(
219            location.to_locations(),
220            category,
221            param_env.and(type_op::normalize::Normalize { value }),
222        );
223        result.unwrap_or(value)
224    }
225
226    #[instrument(skip(self), level = "debug")]
227    pub(super) fn struct_tail(
228        &mut self,
229        ty: Ty<'tcx>,
230        location: impl NormalizeLocation,
231    ) -> Ty<'tcx> {
232        let tcx = self.tcx();
233        if self.infcx.next_trait_solver() {
234            let body = self.body;
235            let param_env = self.infcx.param_env;
236            // FIXME: Make this into a real type op?
237            self.fully_perform_op(
238                location.to_locations(),
239                ConstraintCategory::Boring,
240                CustomTypeOp::new(
241                    |ocx| {
242                        let structurally_normalize = |ty| {
243                            ocx.structurally_normalize_ty(
244                                &ObligationCause::misc(
245                                    location.to_locations().span(body),
246                                    body.source.def_id().expect_local(),
247                                ),
248                                param_env,
249                                ty,
250                            )
251                            .unwrap_or_else(|_| bug!("struct tail should have been computable, since we computed it in HIR"))
252                        };
253
254                        let tail = tcx.struct_tail_raw(
255                            ty,
256                            structurally_normalize,
257                            || {},
258                        );
259
260                        Ok(tail)
261                    },
262                    "normalizing struct tail",
263                ),
264            )
265            .unwrap_or_else(|guar| Ty::new_error(tcx, guar))
266        } else {
267            let mut normalize = |ty| self.normalize(ty, location);
268            let tail = tcx.struct_tail_raw(ty, &mut normalize, || {});
269            normalize(tail)
270        }
271    }
272
273    #[instrument(skip(self), level = "debug")]
274    pub(super) fn structurally_resolve(
275        &mut self,
276        ty: Ty<'tcx>,
277        location: impl NormalizeLocation,
278    ) -> Ty<'tcx> {
279        if self.infcx.next_trait_solver() {
280            let body = self.body;
281            let param_env = self.infcx.param_env;
282            // FIXME: Make this into a real type op?
283            self.fully_perform_op(
284                location.to_locations(),
285                ConstraintCategory::Boring,
286                CustomTypeOp::new(
287                    |ocx| {
288                        ocx.structurally_normalize_ty(
289                            &ObligationCause::misc(
290                                location.to_locations().span(body),
291                                body.source.def_id().expect_local(),
292                            ),
293                            param_env,
294                            ty,
295                        )
296                        .map_err(|_| NoSolution)
297                    },
298                    "normalizing struct tail",
299                ),
300            )
301            .unwrap_or_else(|guar| Ty::new_error(self.tcx(), guar))
302        } else {
303            self.normalize(ty, location)
304        }
305    }
306
307    #[instrument(skip(self), level = "debug")]
308    pub(super) fn ascribe_user_type(
309        &mut self,
310        mir_ty: Ty<'tcx>,
311        user_ty: ty::UserType<'tcx>,
312        span: Span,
313    ) {
314        let _: Result<_, ErrorGuaranteed> = self.fully_perform_op(
315            Locations::All(span),
316            ConstraintCategory::Boring,
317            self.infcx
318                .param_env
319                .and(type_op::ascribe_user_type::AscribeUserType { mir_ty, user_ty }),
320        );
321    }
322
323    /// *Incorrectly* skips the WF checks we normally do in `ascribe_user_type`.
324    ///
325    /// FIXME(#104478, #104477): This is a hack for backward-compatibility.
326    #[instrument(skip(self), level = "debug")]
327    pub(super) fn ascribe_user_type_skip_wf(
328        &mut self,
329        mir_ty: Ty<'tcx>,
330        user_ty: ty::UserType<'tcx>,
331        span: Span,
332    ) {
333        let ty::UserTypeKind::Ty(user_ty) = user_ty.kind else { bug!() };
334
335        // A fast path for a common case with closure input/output types.
336        if let ty::Infer(_) = user_ty.kind() {
337            self.eq_types(user_ty, mir_ty, Locations::All(span), ConstraintCategory::Boring)
338                .unwrap();
339            return;
340        }
341
342        // FIXME: Ideally MIR types are normalized, but this is not always true.
343        let mir_ty = self.normalize(mir_ty, Locations::All(span));
344
345        let cause = ObligationCause::dummy_with_span(span);
346        let param_env = self.infcx.param_env;
347        let _: Result<_, ErrorGuaranteed> = self.fully_perform_op(
348            Locations::All(span),
349            ConstraintCategory::Boring,
350            type_op::custom::CustomTypeOp::new(
351                |ocx| {
352                    let user_ty = ocx.normalize(&cause, param_env, user_ty);
353                    ocx.eq(&cause, param_env, user_ty, mir_ty)?;
354                    Ok(())
355                },
356                "ascribe_user_type_skip_wf",
357            ),
358        );
359    }
360}