Skip to main content

rustc_mir_build/thir/pattern/
const_to_pat.rs

1use core::ops::ControlFlow;
2
3use rustc_abi::{FieldIdx, VariantIdx};
4use rustc_apfloat::Float;
5use rustc_data_structures::fx::FxHashSet;
6use rustc_errors::{Diag, msg};
7use rustc_hir as hir;
8use rustc_hir::find_attr;
9use rustc_index::Idx;
10use rustc_infer::infer::TyCtxtInferExt;
11use rustc_infer::traits::Obligation;
12use rustc_middle::mir::interpret::ErrorHandled;
13use rustc_middle::span_bug;
14use rustc_middle::thir::{FieldPat, Pat, PatKind};
15use rustc_middle::ty::{
16    self, Ty, TyCtxt, TypeSuperVisitable, TypeVisitableExt, TypeVisitor, Unnormalized,
17};
18use rustc_span::def_id::DefId;
19use rustc_span::{DUMMY_SP, Span};
20use rustc_trait_selection::error_reporting::traits::ambiguity::{
21    CandidateSource, compute_applicable_impls_for_diagnostics,
22};
23use rustc_trait_selection::traits::ObligationCause;
24use rustc_trait_selection::traits::query::evaluate_obligation::InferCtxtExt;
25use tracing::{debug, instrument, trace};
26
27use super::PatCtxt;
28use crate::diagnostics::{
29    ConstPatternDependsOnGenericParameter, CouldNotEvalConstPattern, InvalidPattern, NaNPattern,
30    PointerPattern, SuggestEq, TypeNotPartialEq, TypeNotStructural, UnionPattern, UnsizedPattern,
31};
32
33impl<'tcx, 'ptcx> PatCtxt<'tcx, 'ptcx> {
34    /// Converts a constant to a pattern (if possible).
35    /// This means aggregate values (like structs and enums) are converted
36    /// to a pattern that matches the value (as if you'd compared via structural equality).
37    ///
38    /// Only type system constants are supported, as we are using valtrees
39    /// as an intermediate step. Unfortunately those don't carry a type
40    /// so we have to carry one ourselves.
41    x;#[instrument(level = "debug", skip(self), ret)]
42    pub(super) fn const_to_pat(
43        &self,
44        c: ty::Const<'tcx>,
45        ty: Ty<'tcx>,
46        id: hir::HirId,
47        span: Span,
48    ) -> Box<Pat<'tcx>> {
49        let mut convert = ConstToPat::new(self, id, span, c);
50
51        match c.kind() {
52            ty::ConstKind::Alias(_, alias_const) => convert.alias_to_pat(alias_const, ty),
53            ty::ConstKind::Value(value) => convert.valtree_to_pat(value),
54            _ => span_bug!(span, "Invalid `ConstKind` for `const_to_pat`: {:?}", c),
55        }
56    }
57}
58
59struct ConstToPat<'tcx> {
60    tcx: TyCtxt<'tcx>,
61    typing_env: ty::TypingEnv<'tcx>,
62    span: Span,
63    id: hir::HirId,
64
65    c: ty::Const<'tcx>,
66}
67
68impl<'tcx> ConstToPat<'tcx> {
69    fn new(pat_ctxt: &PatCtxt<'tcx, '_>, id: hir::HirId, span: Span, c: ty::Const<'tcx>) -> Self {
70        {
    use ::tracing::__macro_support::Callsite as _;
    static __CALLSITE: ::tracing::callsite::DefaultCallsite =
        {
            static META: ::tracing::Metadata<'static> =
                {
                    ::tracing_core::metadata::Metadata::new("event compiler/rustc_mir_build/src/thir/pattern/const_to_pat.rs:70",
                        "rustc_mir_build::thir::pattern::const_to_pat",
                        ::tracing::Level::TRACE,
                        ::tracing_core::__macro_support::Option::Some("compiler/rustc_mir_build/src/thir/pattern/const_to_pat.rs"),
                        ::tracing_core::__macro_support::Option::Some(70u32),
                        ::tracing_core::__macro_support::Option::Some("rustc_mir_build::thir::pattern::const_to_pat"),
                        ::tracing_core::field::FieldSet::new(&[{
                                            const NAME:
                                                ::tracing::__macro_support::FieldName<{
                                                    ::tracing::__macro_support::FieldName::len("pat_ctxt.typeck_results.hir_owner")
                                                }> =
                                                ::tracing::__macro_support::FieldName::new("pat_ctxt.typeck_results.hir_owner");
                                            NAME.as_str()
                                        }], ::tracing_core::callsite::Identifier(&__CALLSITE)),
                        ::tracing::metadata::Kind::EVENT)
                };
            ::tracing::callsite::DefaultCallsite::new(&META)
        };
    let enabled =
        ::tracing::Level::TRACE <= ::tracing::level_filters::STATIC_MAX_LEVEL
                &&
                ::tracing::Level::TRACE <=
                    ::tracing::level_filters::LevelFilter::current() &&
            {
                let interest = __CALLSITE.interest();
                !interest.is_never() &&
                    ::tracing::__macro_support::__is_enabled(__CALLSITE.metadata(),
                        interest)
            };
    if enabled {
        (|value_set: ::tracing::field::ValueSet|
                    {
                        let meta = __CALLSITE.metadata();
                        ::tracing::Event::dispatch(meta, &value_set);
                        ;
                    })({
                #[allow(unused_imports)]
                use ::tracing::field::{debug, display, Value};
                __CALLSITE.metadata().fields().value_set_all(&[(::tracing::__macro_support::Option::Some(&::tracing::field::debug(&pat_ctxt.typeck_results.hir_owner)
                                            as &dyn ::tracing::field::Value))])
            });
    } else { ; }
};trace!(?pat_ctxt.typeck_results.hir_owner);
71        ConstToPat { tcx: pat_ctxt.tcx, typing_env: pat_ctxt.typing_env, span, id, c }
72    }
73
74    fn type_marked_structural(&self, ty: Ty<'tcx>) -> bool {
75        ty.is_structural_eq_shallow(self.tcx)
76    }
77
78    /// We errored. Signal that in the pattern, so that follow up errors can be silenced.
79    fn mk_err(&self, mut err: Diag<'_>, ty: Ty<'tcx>) -> Box<Pat<'tcx>> {
80        if let ty::ConstKind::Alias(_, alias_const) = self.c.kind() {
81            if let ty::AliasConstKind::Projection { def_id }
82            | ty::AliasConstKind::Inherent { def_id } = alias_const.kind
83                && let Some(def_id) = def_id.as_local()
84            {
85                // Include the container item in the output.
86                err.span_label(self.tcx.def_span(self.tcx.local_parent(def_id)), "");
87            }
88            if let ty::AliasConstKind::Projection { def_id }
89            | ty::AliasConstKind::Inherent { def_id }
90            | ty::AliasConstKind::Free { def_id } = alias_const.kind
91            {
92                err.span_label(self.tcx.def_span(def_id), rustc_errors::DiagMessage::Inline(std::borrow::Cow::Borrowed("constant defined here"))msg!("constant defined here"));
93            }
94        }
95        Box::new(Pat { span: self.span, ty, kind: PatKind::Error(err.emit()), extra: None })
96    }
97
98    fn alias_to_pat(&mut self, alias_const: ty::AliasConst<'tcx>, ty: Ty<'tcx>) -> Box<Pat<'tcx>> {
99        // It's not *technically* correct to be revealing opaque types here as borrowcheck has
100        // not run yet. However, CTFE itself uses `TypingMode::PostAnalysis` unconditionally even
101        // during typeck and not doing so has a lot of (undesirable) fallout (#101478, #119821).
102        // As a result we always use a revealed env when resolving the instance to evaluate.
103        //
104        // FIXME: `const_eval_resolve_for_typeck` should probably just modify the env itself
105        // instead of having this logic here
106        let typing_env =
107            self.tcx.erase_and_anonymize_regions(self.typing_env).with_codegen_normalized(self.tcx);
108        let alias_const = self.tcx.erase_and_anonymize_regions(alias_const);
109
110        // FIXME(gca): This will become insufficient once associated constants can be
111        // implemented as `type` consts (project-const-generics#76). At that point it'll
112        // become necessary to just use type system normalization for all const patterns
113        // but that's not yet possible.
114        let mut thir_pat = if alias_const.kind.is_type_const(self.tcx) {
115            let Ok(normalize) = self
116                .tcx
117                .try_normalize_erasing_regions(self.typing_env, Unnormalized::new_wip(self.c))
118            else {
119                let err = self.tcx.dcx().create_err(CouldNotEvalConstPattern { span: self.span });
120                return self.mk_err(err, ty);
121            };
122
123            let ty::ConstKind::Value(value) = normalize.kind() else {
124                let err = self.tcx.dcx().create_err(CouldNotEvalConstPattern { span: self.span });
125                return self.mk_err(err, ty);
126            };
127            self.valtree_to_pat(value)
128        } else {
129            // try to resolve e.g. associated constants to their definition on an impl, and then
130            // evaluate the const.
131            let valtree =
132                match self.tcx.const_eval_resolve_for_typeck(typing_env, alias_const, self.span) {
133                    Ok(Ok(c)) => c,
134                    Err(ErrorHandled::Reported(_, _)) => {
135                        // Let's tell the use where this failing const occurs.
136                        let mut err =
137                            self.tcx.dcx().create_err(CouldNotEvalConstPattern { span: self.span });
138                        // We've emitted an error on the original const, it would be redundant to complain
139                        // on its use as well.
140                        if let ty::ConstKind::Alias(_, alias_const) = self.c.kind()
141                            && let ty::AliasConstKind::Projection { .. }
142                            | ty::AliasConstKind::Inherent { .. }
143                            | ty::AliasConstKind::Free { .. } = alias_const.kind
144                        {
145                            err.downgrade_to_delayed_bug();
146                        }
147                        return self.mk_err(err, ty);
148                    }
149                    Err(ErrorHandled::TooGeneric(_)) => {
150                        let mut err = self
151                            .tcx
152                            .dcx()
153                            .create_err(ConstPatternDependsOnGenericParameter { span: self.span });
154                        for arg in alias_const.args {
155                            if let ty::GenericArgKind::Type(ty) = arg.kind()
156                                && let ty::Param(param_ty) = ty.kind()
157                            {
158                                let def_id = self.tcx.hir_enclosing_body_owner(self.id);
159                                let generics = self.tcx.generics_of(def_id);
160                                let param = generics.type_param(*param_ty, self.tcx);
161                                let span = self.tcx.def_span(param.def_id);
162                                err.span_label(span, "constant depends on this generic parameter");
163                                if let Some(ident) = self.tcx.def_ident_span(def_id)
164                                    && self.tcx.sess.source_map().is_multiline(ident.between(span))
165                                {
166                                    // Display the `fn` name as well in the diagnostic, as the generic isn't
167                                    // in the same line and it could be confusing otherwise.
168                                    err.span_label(ident, "");
169                                }
170                            }
171                        }
172                        return self.mk_err(err, ty);
173                    }
174                    Ok(Err(bad_ty)) => {
175                        // The pattern cannot be turned into a valtree.
176                        let e = match bad_ty.kind() {
177                            ty::Adt(def, ..) => {
178                                if !def.is_union() {
    ::core::panicking::panic("assertion failed: def.is_union()")
};assert!(def.is_union());
179                                self.tcx.dcx().create_err(UnionPattern { span: self.span })
180                            }
181                            ty::FnPtr(..) | ty::RawPtr(..) => {
182                                self.tcx.dcx().create_err(PointerPattern { span: self.span })
183                            }
184                            _ => self.tcx.dcx().create_err(InvalidPattern {
185                                span: self.span,
186                                non_sm_ty: bad_ty,
187                                prefix: bad_ty.prefix_string(self.tcx).to_string(),
188                            }),
189                        };
190                        return self.mk_err(e, ty);
191                    }
192                };
193
194            // Lower the valtree to a THIR pattern.
195            self.valtree_to_pat(ty::Value { ty, valtree })
196        };
197
198        if !thir_pat.references_error() {
199            // Always check for `PartialEq` if we had no other errors yet.
200            if !type_has_partial_eq_impl(self.tcx, typing_env, ty).has_impl {
201                let mut err = self.tcx.dcx().create_err(TypeNotPartialEq { span: self.span, ty });
202                extend_type_not_partial_eq(self.tcx, typing_env, ty, &mut err);
203                return self.mk_err(err, ty);
204            }
205        }
206
207        // Mark the pattern to indicate that it is the result of lowering a named
208        // constant. This is used for diagnostics.
209        thir_pat.extra.get_or_insert_default().expanded_const = alias_const.kind.opt_def_id();
210        thir_pat
211    }
212
213    fn lower_field_values_to_fieldpats(
214        &self,
215        values: impl Iterator<Item = ty::Value<'tcx>>,
216    ) -> Vec<FieldPat<'tcx>> {
217        values
218            .enumerate()
219            .map(|(index, value)| FieldPat {
220                field: FieldIdx::new(index),
221                pattern: *self.valtree_to_pat(value),
222            })
223            .collect()
224    }
225
226    // Recursive helper for `to_pat`; invoke that (instead of calling this directly).
227    #[allow(clippy :: suspicious_else_formatting)]
{
    let __tracing_attr_span;
    let __tracing_attr_guard;
    if ::tracing::Level::DEBUG <= ::tracing::level_filters::STATIC_MAX_LEVEL
                &&
                ::tracing::Level::DEBUG <=
                    ::tracing::level_filters::LevelFilter::current() ||
            { false } {
        __tracing_attr_span =
            {
                use ::tracing::__macro_support::Callsite as _;
                static __CALLSITE: ::tracing::callsite::DefaultCallsite =
                    {
                        static META: ::tracing::Metadata<'static> =
                            {
                                ::tracing_core::metadata::Metadata::new("valtree_to_pat",
                                    "rustc_mir_build::thir::pattern::const_to_pat",
                                    ::tracing::Level::DEBUG,
                                    ::tracing_core::__macro_support::Option::Some("compiler/rustc_mir_build/src/thir/pattern/const_to_pat.rs"),
                                    ::tracing_core::__macro_support::Option::Some(227u32),
                                    ::tracing_core::__macro_support::Option::Some("rustc_mir_build::thir::pattern::const_to_pat"),
                                    ::tracing_core::field::FieldSet::new(&[{
                                                        const NAME:
                                                            ::tracing::__macro_support::FieldName<{
                                                                ::tracing::__macro_support::FieldName::len("value")
                                                            }> =
                                                            ::tracing::__macro_support::FieldName::new("value");
                                                        NAME.as_str()
                                                    }], ::tracing_core::callsite::Identifier(&__CALLSITE)),
                                    ::tracing::metadata::Kind::SPAN)
                            };
                        ::tracing::callsite::DefaultCallsite::new(&META)
                    };
                let mut interest = ::tracing::subscriber::Interest::never();
                if ::tracing::Level::DEBUG <=
                                    ::tracing::level_filters::STATIC_MAX_LEVEL &&
                                ::tracing::Level::DEBUG <=
                                    ::tracing::level_filters::LevelFilter::current() &&
                            { interest = __CALLSITE.interest(); !interest.is_never() }
                        &&
                        ::tracing::__macro_support::__is_enabled(__CALLSITE.metadata(),
                            interest) {
                    let meta = __CALLSITE.metadata();
                    ::tracing::Span::new(meta,
                        &{
                                #[allow(unused_imports)]
                                use ::tracing::field::{debug, display, Value};
                                meta.fields().value_set_all(&[(::tracing::__macro_support::Option::Some(&::tracing::field::debug(&value)
                                                            as &dyn ::tracing::field::Value))])
                            })
                } else {
                    let span =
                        ::tracing::__macro_support::__disabled_span(__CALLSITE.metadata());
                    {};
                    span
                }
            };
        __tracing_attr_guard = __tracing_attr_span.enter();
    }

    #[warn(clippy :: suspicious_else_formatting)]
    {

        #[allow(unknown_lints, unreachable_code, clippy ::
        diverging_sub_expression, clippy :: empty_loop, clippy ::
        let_unit_value, clippy :: let_with_type_underscore, clippy ::
        needless_return, clippy :: unreachable)]
        if false {
            let __tracing_attr_fake_return: Box<Pat<'tcx>> = loop {};
            return __tracing_attr_fake_return;
        }
        {
            let span = self.span;
            let tcx = self.tcx;
            let ty::Value { ty, valtree } = value;
            let kind =
                match ty.kind() {
                    ty::Adt(adt_def, _) if !self.type_marked_structural(ty) => {
                        {
                            use ::tracing::__macro_support::Callsite as _;
                            static __CALLSITE: ::tracing::callsite::DefaultCallsite =
                                {
                                    static META: ::tracing::Metadata<'static> =
                                        {
                                            ::tracing_core::metadata::Metadata::new("event compiler/rustc_mir_build/src/thir/pattern/const_to_pat.rs:239",
                                                "rustc_mir_build::thir::pattern::const_to_pat",
                                                ::tracing::Level::DEBUG,
                                                ::tracing_core::__macro_support::Option::Some("compiler/rustc_mir_build/src/thir/pattern/const_to_pat.rs"),
                                                ::tracing_core::__macro_support::Option::Some(239u32),
                                                ::tracing_core::__macro_support::Option::Some("rustc_mir_build::thir::pattern::const_to_pat"),
                                                ::tracing_core::field::FieldSet::new(&["message",
                                                                {
                                                                    const NAME:
                                                                        ::tracing::__macro_support::FieldName<{
                                                                            ::tracing::__macro_support::FieldName::len("adt_def")
                                                                        }> =
                                                                        ::tracing::__macro_support::FieldName::new("adt_def");
                                                                    NAME.as_str()
                                                                },
                                                                {
                                                                    const NAME:
                                                                        ::tracing::__macro_support::FieldName<{
                                                                            ::tracing::__macro_support::FieldName::len("value.ty")
                                                                        }> =
                                                                        ::tracing::__macro_support::FieldName::new("value.ty");
                                                                    NAME.as_str()
                                                                }], ::tracing_core::callsite::Identifier(&__CALLSITE)),
                                                ::tracing::metadata::Kind::EVENT)
                                        };
                                    ::tracing::callsite::DefaultCallsite::new(&META)
                                };
                            let enabled =
                                ::tracing::Level::DEBUG <=
                                            ::tracing::level_filters::STATIC_MAX_LEVEL &&
                                        ::tracing::Level::DEBUG <=
                                            ::tracing::level_filters::LevelFilter::current() &&
                                    {
                                        let interest = __CALLSITE.interest();
                                        !interest.is_never() &&
                                            ::tracing::__macro_support::__is_enabled(__CALLSITE.metadata(),
                                                interest)
                                    };
                            if enabled {
                                (|value_set: ::tracing::field::ValueSet|
                                            {
                                                let meta = __CALLSITE.metadata();
                                                ::tracing::Event::dispatch(meta, &value_set);
                                                ;
                                            })({
                                        #[allow(unused_imports)]
                                        use ::tracing::field::{debug, display, Value};
                                        __CALLSITE.metadata().fields().value_set_all(&[(::tracing::__macro_support::Option::Some(&format_args!("ADT type in pattern is not `type_marked_structural`")
                                                                    as &dyn ::tracing::field::Value)),
                                                        (::tracing::__macro_support::Option::Some(&::tracing::field::debug(&adt_def)
                                                                    as &dyn ::tracing::field::Value)),
                                                        (::tracing::__macro_support::Option::Some(&::tracing::field::debug(&value.ty)
                                                                    as &dyn ::tracing::field::Value))])
                                    });
                            } else { ; }
                        };
                        let PartialEqImplStatus {
                                is_derived,
                                possibly_inapplicable_structural_partial_eq,
                                non_blanket_impl,
                                possibly_inapplicable_derived_partial_eq,
                                has_impl, .. } =
                            type_has_partial_eq_impl(self.tcx, self.typing_env, ty);
                        if possibly_inapplicable_derived_partial_eq && !has_impl {
                            let mut err =
                                self.tcx.dcx().create_err(TypeNotPartialEq {
                                        span: self.span,
                                        ty,
                                    });
                            extend_type_not_partial_eq(self.tcx, self.typing_env, ty,
                                &mut err);
                            return self.mk_err(err, ty);
                        }
                        let (manual_partialeq_impl_span,
                                manual_partialeq_impl_note) =
                            match (possibly_inapplicable_structural_partial_eq,
                                    non_blanket_impl) {
                                (true, _) => (None, false),
                                (_, Some(def_id)) if def_id.is_local() && !is_derived => {
                                    (Some(tcx.def_span(def_id)), false)
                                }
                                _ => (None, true),
                            };
                        let manual_partialeq_impl =
                            manual_partialeq_impl_note ||
                                manual_partialeq_impl_span.is_some();
                        let is_local = adt_def.did().is_local();
                        let ty_def_span = tcx.def_span(adt_def.did());
                        let suggestion =
                            if let Ok(name) =
                                        tcx.sess.source_map().span_to_snippet(self.span) &&
                                    (is_local || manual_partialeq_impl) {
                                let mut hir_id = self.id;
                                while let hir::Node::Pat(pat) = tcx.parent_hir_node(hir_id)
                                    {
                                    hir_id = pat.hir_id;
                                }
                                match tcx.parent_hir_node(hir_id) {
                                    hir::Node::Arm(hir::Arm { pat, guard: None, .. }) => {
                                        Some(SuggestEq::AddIf {
                                                if_span: pat.span.shrink_to_hi(),
                                                pat_span: self.span,
                                                name,
                                                ty,
                                                manual_partialeq_impl,
                                            })
                                    }
                                    hir::Node::Arm(hir::Arm { guard: Some(guard), .. }) => {
                                        Some(SuggestEq::AddToIf {
                                                span: guard.span.shrink_to_hi(),
                                                pat_span: self.span,
                                                name,
                                                ty,
                                                manual_partialeq_impl,
                                            })
                                    }
                                    hir::Node::Expr(hir::Expr {
                                        kind: hir::ExprKind::Let(let_expr), span, .. }) => {
                                        if let_expr.pat.span == self.span {
                                            Some(SuggestEq::ReplaceWithEq {
                                                    removal: span.until(self.span),
                                                    eq: self.span.between(let_expr.init.span),
                                                    ty,
                                                    manual_partialeq_impl,
                                                })
                                        } else if tcx.sess.edition().at_least_rust_2024() {
                                            Some(SuggestEq::AddToLetChain {
                                                    span: span.shrink_to_hi(),
                                                    pat_span: self.span,
                                                    name,
                                                    ty,
                                                    manual_partialeq_impl,
                                                })
                                        } else { None }
                                    }
                                    hir::Node::LetStmt(let_stmt) if
                                        let Some(init) = let_stmt.init &&
                                                    let Some(els) = let_stmt.els && init.span.ctxt().is_root()
                                            && els.span.ctxt().is_root() => {
                                        Some(SuggestEq::ReplaceLetElseWithIf {
                                                if_span: let_stmt.span.until(let_stmt.pat.span),
                                                eq: let_stmt.pat.span.between(init.span),
                                                else_span: init.span.between(els.span),
                                                ty,
                                                manual_partialeq_impl,
                                            })
                                    }
                                    _ => None,
                                }
                            } else { None };
                        let err =
                            TypeNotStructural {
                                span,
                                ty,
                                ty_def_span,
                                manual_partialeq_impl_span,
                                manual_partialeq_impl_note,
                                is_local,
                                suggestion,
                            };
                        return self.mk_err(tcx.dcx().create_err(err), ty);
                    }
                    ty::Adt(adt_def, args) if adt_def.is_enum() => {
                        let (&variant_index, fields) =
                            valtree.to_branch().split_first().unwrap();
                        let variant_index =
                            VariantIdx::from_u32(variant_index.to_leaf().to_u32());
                        PatKind::Variant {
                            adt_def: *adt_def,
                            args,
                            variant_index,
                            subpatterns: self.lower_field_values_to_fieldpats(fields.iter().map(|ct|
                                        ct.to_value())),
                        }
                    }
                    ty::Adt(def, _) => {
                        if !!def.is_union() {
                            ::core::panicking::panic("assertion failed: !def.is_union()")
                        };
                        PatKind::Leaf {
                            subpatterns: self.lower_field_values_to_fieldpats(valtree.to_branch().iter().map(|ct|
                                        ct.to_value())),
                        }
                    }
                    ty::Tuple(_) =>
                        PatKind::Leaf {
                            subpatterns: self.lower_field_values_to_fieldpats(valtree.to_branch().iter().map(|ct|
                                        ct.to_value())),
                        },
                    ty::Slice(_) =>
                        PatKind::Slice {
                            prefix: valtree.to_branch().iter().map(|val|
                                        *self.valtree_to_pat(val.to_value())).collect(),
                            slice: None,
                            suffix: Box::new([]),
                        },
                    ty::Array(_, _) =>
                        PatKind::Array {
                            prefix: valtree.to_branch().iter().map(|val|
                                        *self.valtree_to_pat(val.to_value())).collect(),
                            slice: None,
                            suffix: Box::new([]),
                        },
                    ty::Str => { PatKind::Constant { value } }
                    ty::Ref(_, pointee_ty, ..) => {
                        if pointee_ty.is_str() || pointee_ty.is_slice() ||
                                pointee_ty.is_sized(tcx, self.typing_env) {
                            PatKind::Deref {
                                pin: hir::Pinnedness::Not,
                                subpattern: self.valtree_to_pat(ty::Value {
                                        ty: *pointee_ty,
                                        valtree,
                                    }),
                            }
                        } else {
                            return self.mk_err(tcx.dcx().create_err(UnsizedPattern {
                                            span,
                                            non_sm_ty: *pointee_ty,
                                        }), ty);
                        }
                    }
                    ty::Float(flt) => {
                        let v = valtree.to_leaf();
                        let is_nan =
                            match flt {
                                ty::FloatTy::F16 => v.to_f16().is_nan(),
                                ty::FloatTy::F32 => v.to_f32().is_nan(),
                                ty::FloatTy::F64 => v.to_f64().is_nan(),
                                ty::FloatTy::F128 => v.to_f128().is_nan(),
                            };
                        if is_nan {
                            return self.mk_err(tcx.dcx().create_err(NaNPattern {
                                            span,
                                        }), ty);
                        } else { PatKind::Constant { value } }
                    }
                    ty::Pat(..) | ty::Bool | ty::Char | ty::Int(_) | ty::Uint(_)
                        | ty::RawPtr(..) => {
                        PatKind::Constant { value }
                    }
                    ty::FnPtr(..) => {
                        {
                            ::core::panicking::panic_fmt(format_args!("internal error: entered unreachable code: {0}",
                                    format_args!("Valtree construction would never succeed for FnPtr, so this is unreachable.")));
                        }
                    }
                    _ => {
                        let err =
                            InvalidPattern {
                                span,
                                non_sm_ty: ty,
                                prefix: ty.prefix_string(tcx).to_string(),
                            };
                        return self.mk_err(tcx.dcx().create_err(err), ty);
                    }
                };
            Box::new(Pat { span, ty, kind, extra: None })
        }
    }
}#[instrument(skip(self), level = "debug")]
228    fn valtree_to_pat(&self, value: ty::Value<'tcx>) -> Box<Pat<'tcx>> {
229        let span = self.span;
230        let tcx = self.tcx;
231        let ty::Value { ty, valtree } = value;
232
233        let kind = match ty.kind() {
234            // Extremely important check for all ADTs!
235            // Make sure they are eligible to be used in patterns (structural), and if not, emit an
236            // error.
237            ty::Adt(adt_def, _) if !self.type_marked_structural(ty) => {
238                // This ADT cannot be used as a constant in patterns.
239                debug!(?adt_def, ?value.ty, "ADT type in pattern is not `type_marked_structural`");
240                let PartialEqImplStatus {
241                    is_derived,
242                    possibly_inapplicable_structural_partial_eq,
243                    non_blanket_impl,
244                    possibly_inapplicable_derived_partial_eq,
245                    has_impl,
246                    ..
247                } = type_has_partial_eq_impl(self.tcx, self.typing_env, ty);
248
249                // If we have a derived PartialEq impl but it does not apply,
250                // then error about that instead, because `TypeNotStructural` gives advice that is
251                // relevant only when the problem is that `ty` does not derive `PartialEq`.
252                //
253                // Note that this is a duplicate of a check in `alias_to_pat()`,
254                // which we would run later if we weren’t emitting an error now.
255                if possibly_inapplicable_derived_partial_eq && !has_impl {
256                    let mut err =
257                        self.tcx.dcx().create_err(TypeNotPartialEq { span: self.span, ty });
258                    extend_type_not_partial_eq(self.tcx, self.typing_env, ty, &mut err);
259                    return self.mk_err(err, ty);
260                }
261
262                let (manual_partialeq_impl_span, manual_partialeq_impl_note) =
263                    match (possibly_inapplicable_structural_partial_eq, non_blanket_impl) {
264                        (true, _) => (None, false),
265                        (_, Some(def_id)) if def_id.is_local() && !is_derived => {
266                            (Some(tcx.def_span(def_id)), false)
267                        }
268                        _ => (None, true),
269                    };
270                let manual_partialeq_impl =
271                    manual_partialeq_impl_note || manual_partialeq_impl_span.is_some();
272                let is_local = adt_def.did().is_local();
273                let ty_def_span = tcx.def_span(adt_def.did());
274                let suggestion = if let Ok(name) = tcx.sess.source_map().span_to_snippet(self.span)
275                    && (is_local || manual_partialeq_impl)
276                {
277                    let mut hir_id = self.id;
278                    while let hir::Node::Pat(pat) = tcx.parent_hir_node(hir_id) {
279                        hir_id = pat.hir_id;
280                    }
281                    match tcx.parent_hir_node(hir_id) {
282                        hir::Node::Arm(hir::Arm { pat, guard: None, .. }) => {
283                            // Add an if condition to the match arm.
284                            Some(SuggestEq::AddIf {
285                                if_span: pat.span.shrink_to_hi(),
286                                pat_span: self.span,
287                                name,
288                                ty,
289                                manual_partialeq_impl,
290                            })
291                        }
292                        hir::Node::Arm(hir::Arm { guard: Some(guard), .. }) => {
293                            // Modify the the match arm if condition and add a check for equality.
294                            Some(SuggestEq::AddToIf {
295                                span: guard.span.shrink_to_hi(),
296                                pat_span: self.span,
297                                name,
298                                ty,
299                                manual_partialeq_impl,
300                            })
301                        }
302                        hir::Node::Expr(hir::Expr {
303                            kind: hir::ExprKind::Let(let_expr),
304                            span,
305                            ..
306                        }) => {
307                            if let_expr.pat.span == self.span {
308                                // `if let CONST = expr` -> `if CONST == expr`.
309                                Some(SuggestEq::ReplaceWithEq {
310                                    removal: span.until(self.span),
311                                    eq: self.span.between(let_expr.init.span),
312                                    ty,
313                                    manual_partialeq_impl,
314                                })
315                            } else if tcx.sess.edition().at_least_rust_2024() {
316                                // `if let Some(CONST) = expr` ->
317                                // `if let Some(binding) = expr && binding == CONST`.
318                                Some(SuggestEq::AddToLetChain {
319                                    span: span.shrink_to_hi(),
320                                    pat_span: self.span,
321                                    name,
322                                    ty,
323                                    manual_partialeq_impl,
324                                })
325                            } else {
326                                None
327                            }
328                        }
329                        hir::Node::LetStmt(let_stmt)
330                            if let Some(init) = let_stmt.init
331                                && let Some(els) = let_stmt.els
332                                && init.span.ctxt().is_root()
333                                && els.span.ctxt().is_root() =>
334                        {
335                            // `let PAT = expr else {` -> `if PAT == expr {`.
336                            Some(SuggestEq::ReplaceLetElseWithIf {
337                                if_span: let_stmt.span.until(let_stmt.pat.span),
338                                eq: let_stmt.pat.span.between(init.span),
339                                else_span: init.span.between(els.span),
340                                ty,
341                                manual_partialeq_impl,
342                            })
343                        }
344                        _ => None,
345                    }
346                } else {
347                    None
348                };
349                let err = TypeNotStructural {
350                    span,
351                    ty,
352                    ty_def_span,
353                    manual_partialeq_impl_span,
354                    manual_partialeq_impl_note,
355                    is_local,
356                    suggestion,
357                };
358                return self.mk_err(tcx.dcx().create_err(err), ty);
359            }
360            ty::Adt(adt_def, args) if adt_def.is_enum() => {
361                let (&variant_index, fields) = valtree.to_branch().split_first().unwrap();
362                let variant_index = VariantIdx::from_u32(variant_index.to_leaf().to_u32());
363                PatKind::Variant {
364                    adt_def: *adt_def,
365                    args,
366                    variant_index,
367                    subpatterns: self
368                        .lower_field_values_to_fieldpats(fields.iter().map(|ct| ct.to_value())),
369                }
370            }
371            ty::Adt(def, _) => {
372                assert!(!def.is_union()); // Valtree construction would never succeed for unions.
373                PatKind::Leaf {
374                    subpatterns: self.lower_field_values_to_fieldpats(
375                        valtree.to_branch().iter().map(|ct| ct.to_value()),
376                    ),
377                }
378            }
379            ty::Tuple(_) => PatKind::Leaf {
380                subpatterns: self.lower_field_values_to_fieldpats(
381                    valtree.to_branch().iter().map(|ct| ct.to_value()),
382                ),
383            },
384            ty::Slice(_) => PatKind::Slice {
385                prefix: valtree
386                    .to_branch()
387                    .iter()
388                    .map(|val| *self.valtree_to_pat(val.to_value()))
389                    .collect(),
390                slice: None,
391                suffix: Box::new([]),
392            },
393            ty::Array(_, _) => PatKind::Array {
394                prefix: valtree
395                    .to_branch()
396                    .iter()
397                    .map(|val| *self.valtree_to_pat(val.to_value()))
398                    .collect(),
399                slice: None,
400                suffix: Box::new([]),
401            },
402            ty::Str => {
403                // Constant/literal patterns of type `&str` are lowered to a
404                // `PatKind::Deref` wrapping a `PatKind::Constant` of type `str`.
405                // This pattern node is the `str` constant part.
406                //
407                // Under `feature(deref_patterns)`, string literal patterns can also
408                // have type `str` directly, without the `&`, in order to allow things
409                // like `deref!("...")` to work when the scrutinee is `String`.
410                PatKind::Constant { value }
411            }
412            ty::Ref(_, pointee_ty, ..) => {
413                if pointee_ty.is_str()
414                    || pointee_ty.is_slice()
415                    || pointee_ty.is_sized(tcx, self.typing_env)
416                {
417                    PatKind::Deref {
418                        // This node has type `ty::Ref`, so it's not a pin-deref.
419                        pin: hir::Pinnedness::Not,
420                        // Lower the valtree to a pattern as the pointee type.
421                        // This works because references have the same valtree
422                        // representation as their pointee.
423                        subpattern: self.valtree_to_pat(ty::Value { ty: *pointee_ty, valtree }),
424                    }
425                } else {
426                    return self.mk_err(
427                        tcx.dcx().create_err(UnsizedPattern { span, non_sm_ty: *pointee_ty }),
428                        ty,
429                    );
430                }
431            }
432            ty::Float(flt) => {
433                let v = valtree.to_leaf();
434                let is_nan = match flt {
435                    ty::FloatTy::F16 => v.to_f16().is_nan(),
436                    ty::FloatTy::F32 => v.to_f32().is_nan(),
437                    ty::FloatTy::F64 => v.to_f64().is_nan(),
438                    ty::FloatTy::F128 => v.to_f128().is_nan(),
439                };
440                if is_nan {
441                    // NaNs are not ever equal to anything so they make no sense as patterns.
442                    // Also see <https://github.com/rust-lang/rfcs/pull/3535>.
443                    return self.mk_err(tcx.dcx().create_err(NaNPattern { span }), ty);
444                } else {
445                    PatKind::Constant { value }
446                }
447            }
448            ty::Pat(..) | ty::Bool | ty::Char | ty::Int(_) | ty::Uint(_) | ty::RawPtr(..) => {
449                // The raw pointers we see here have been "vetted" by valtree construction to be
450                // just integers, so we simply allow them.
451                PatKind::Constant { value }
452            }
453            ty::FnPtr(..) => {
454                unreachable!(
455                    "Valtree construction would never succeed for FnPtr, so this is unreachable."
456                )
457            }
458            _ => {
459                let err = InvalidPattern {
460                    span,
461                    non_sm_ty: ty,
462                    prefix: ty.prefix_string(tcx).to_string(),
463                };
464                return self.mk_err(tcx.dcx().create_err(err), ty);
465            }
466        };
467
468        Box::new(Pat { span, ty, kind, extra: None })
469    }
470}
471
472/// Given a type with type parameters, visit every ADT looking for types that need to
473/// `#[derive(PartialEq)]` for it to be a structural type.
474fn extend_type_not_partial_eq<'tcx>(
475    tcx: TyCtxt<'tcx>,
476    typing_env: ty::TypingEnv<'tcx>,
477    ty: Ty<'tcx>,
478    err: &mut Diag<'_>,
479) {
480    /// Collect all types that need to be `StructuralPartialEq`.
481    struct UsedParamsNeedInstantiationVisitor<'tcx> {
482        tcx: TyCtxt<'tcx>,
483        typing_env: ty::TypingEnv<'tcx>,
484        /// The user has written `impl PartialEq for Ty` which means it's non-structural.
485        adts_with_manual_partialeq: FxHashSet<Span>,
486        /// The type has no `PartialEq` implementation, neither manual or derived.
487        adts_without_partialeq: FxHashSet<Span>,
488        /// The user has written `impl PartialEq for Ty` which means it's non-structural,
489        /// but we don't have a span to point at, so we'll just add them as a `note`.
490        manual: FxHashSet<Ty<'tcx>>,
491        /// The type has no `PartialEq` implementation, neither manual or derived, but
492        /// we don't have a span to point at, so we'll just add them as a `note`.
493        without: FxHashSet<Ty<'tcx>>,
494    }
495
496    impl<'tcx> TypeVisitor<TyCtxt<'tcx>> for UsedParamsNeedInstantiationVisitor<'tcx> {
497        type Result = ControlFlow<()>;
498        fn visit_ty(&mut self, ty: Ty<'tcx>) -> Self::Result {
499            match ty.kind() {
500                ty::Dynamic(..) => return ControlFlow::Break(()),
501                // Unsafe binders never implement `PartialEq`, so avoid walking into them
502                // which would require instantiating its binder with placeholders too.
503                ty::UnsafeBinder(..) => return ControlFlow::Break(()),
504                ty::FnPtr(..) => return ControlFlow::Continue(()),
505                ty::Adt(def, _args) => {
506                    let ty_def_id = def.did();
507                    let ty_def_span = self.tcx.def_span(ty_def_id);
508                    let PartialEqImplStatus {
509                        has_impl,
510                        is_derived,
511                        possibly_inapplicable_structural_partial_eq: structural_partial_eq,
512                        non_blanket_impl,
513                        possibly_inapplicable_derived_partial_eq: _,
514                    } = type_has_partial_eq_impl(self.tcx, self.typing_env, ty);
515                    match (has_impl, is_derived, structural_partial_eq, non_blanket_impl) {
516                        (_, _, true, _) => {}
517                        (true, false, _, Some(def_id)) if def_id.is_local() => {
518                            self.adts_with_manual_partialeq.insert(self.tcx.def_span(def_id));
519                        }
520                        (true, false, _, _) if ty_def_id.is_local() => {
521                            self.adts_with_manual_partialeq.insert(ty_def_span);
522                        }
523                        (false, _, _, _) if ty_def_id.is_local() => {
524                            self.adts_without_partialeq.insert(ty_def_span);
525                        }
526                        (true, false, _, _) => {
527                            self.manual.insert(ty);
528                        }
529                        (false, _, _, _) => {
530                            self.without.insert(ty);
531                        }
532                        _ => {}
533                    };
534                    ty.super_visit_with(self)
535                }
536                _ => ty.super_visit_with(self),
537            }
538        }
539    }
540    let mut v = UsedParamsNeedInstantiationVisitor {
541        tcx,
542        typing_env,
543        adts_with_manual_partialeq: FxHashSet::default(),
544        adts_without_partialeq: FxHashSet::default(),
545        manual: FxHashSet::default(),
546        without: FxHashSet::default(),
547    };
548    if v.visit_ty(ty).is_break() {
549        return;
550    }
551    #[allow(rustc::potential_query_instability)] // Span labels will be sorted by the rendering
552    for span in v.adts_with_manual_partialeq {
553        err.span_note(span, "the `PartialEq` trait must be derived, manual `impl`s are not sufficient; see https://doc.rust-lang.org/stable/std/marker/trait.StructuralPartialEq.html for details");
554    }
555    #[allow(rustc::potential_query_instability)] // Span labels will be sorted by the rendering
556    for span in v.adts_without_partialeq {
557        err.span_label(
558            span,
559            "must be annotated with `#[derive(PartialEq)]` to be usable in patterns",
560        );
561    }
562    #[allow(rustc::potential_query_instability)]
563    let mut manual: Vec<_> = v.manual.into_iter().map(|t| t.to_string()).collect();
564    manual.sort();
565    for ty in manual {
566        err.note(::alloc::__export::must_use({
        ::alloc::fmt::format(format_args!("`{0}` must be annotated with `#[derive(PartialEq)]` to be usable in patterns, manual `impl`s are not sufficient; see https://doc.rust-lang.org/stable/std/marker/trait.StructuralPartialEq.html for details",
                ty))
    })format!(
567            "`{ty}` must be annotated with `#[derive(PartialEq)]` to be usable in patterns, manual `impl`s are not sufficient; see https://doc.rust-lang.org/stable/std/marker/trait.StructuralPartialEq.html for details"
568        ));
569    }
570    #[allow(rustc::potential_query_instability)]
571    let mut without: Vec<_> = v.without.into_iter().map(|t| t.to_string()).collect();
572    without.sort();
573    for ty in without {
574        err.note(::alloc::__export::must_use({
        ::alloc::fmt::format(format_args!("`{0}` must be annotated with `#[derive(PartialEq)]` to be usable in patterns",
                ty))
    })format!(
575            "`{ty}` must be annotated with `#[derive(PartialEq)]` to be usable in patterns"
576        ));
577    }
578}
579
580#[derive(#[automatically_derived]
impl ::core::fmt::Debug for PartialEqImplStatus {
    #[inline]
    fn fmt(&self, f: &mut ::core::fmt::Formatter) -> ::core::fmt::Result {
        ::core::fmt::Formatter::debug_struct_field5_finish(f,
            "PartialEqImplStatus", "has_impl", &self.has_impl, "is_derived",
            &self.is_derived, "non_blanket_impl", &self.non_blanket_impl,
            "possibly_inapplicable_structural_partial_eq",
            &self.possibly_inapplicable_structural_partial_eq,
            "possibly_inapplicable_derived_partial_eq",
            &&self.possibly_inapplicable_derived_partial_eq)
    }
}Debug)]
581struct PartialEqImplStatus {
582    /// There is a `PartialEq` impl that applies to the type.
583    has_impl: bool,
584
585    /// The `PartialEq` impl is `#[automatically_derived]`.
586    is_derived: bool,
587    /// The `DefId` of the same impl that `is_derived` refers to.
588    non_blanket_impl: Option<DefId>,
589
590    /// If true, there is a `StructuralPartialEq` implementation,
591    /// but its bounds might not be satisfied.
592    possibly_inapplicable_structural_partial_eq: bool,
593    /// If true, there is a derived `PartialEq` implementation for the type,
594    /// but its bounds might not be satisfied.
595    possibly_inapplicable_derived_partial_eq: bool,
596}
597
598x;#[instrument(level = "trace", skip(tcx), ret)]
599fn type_has_partial_eq_impl<'tcx>(
600    tcx: TyCtxt<'tcx>,
601    typing_env: ty::TypingEnv<'tcx>,
602    ty: Ty<'tcx>,
603) -> PartialEqImplStatus {
604    let (infcx, param_env) = tcx.infer_ctxt().build_with_typing_env(typing_env);
605    // double-check there even *is* a semantic `PartialEq` to dispatch to.
606    //
607    // (If there isn't, then we can safely issue a hard
608    // error, because that's never worked, due to compiler
609    // using `PartialEq::eq` in this scenario in the past.)
610    let partial_eq_trait_id = tcx.require_lang_item(hir::LangItem::PartialEq, DUMMY_SP);
611    let structural_partial_eq_trait_id =
612        tcx.require_lang_item(hir::LangItem::StructuralPeq, DUMMY_SP);
613
614    // This *could* accept a type that isn't actually `PartialEq`, because region bounds get
615    // ignored. However that should be pretty much impossible since consts that do not depend on
616    // generics can only mention the `'static` lifetime, and how would one have a type that's
617    // `PartialEq` for some lifetime but *not* for `'static`? If this ever becomes a problem
618    // we'll need to leave some sort of trace of this requirement in the MIR so that borrowck
619    // can ensure that the type really implements `PartialEq`.
620    // We also do *not* require `const PartialEq`, not even in `const fn`. This violates the model
621    // that patterns can only do things that the code could also do without patterns, but it is
622    // needed for backwards compatibility. The actual pattern matching compares primitive values,
623    // `PartialEq::eq` never gets invoked, so there's no risk of us running non-const code.
624    let has_impl = {
625        let obligation = Obligation::new(
626            tcx,
627            ObligationCause::dummy(),
628            param_env,
629            ty::TraitRef::new(tcx, partial_eq_trait_id, [ty, ty]),
630        );
631        infcx.predicate_must_hold_modulo_regions(&obligation)
632    };
633
634    // Determine whether there are is a derived `PartialEq` implementation, whether or not its
635    // bounds are met.
636    let possibly_inapplicable_derived_partial_eq = {
637        let obligation = Obligation::new(
638            tcx,
639            ObligationCause::dummy(),
640            param_env,
641            ty::Binder::dummy(ty::TraitRef::new(tcx, partial_eq_trait_id, [ty, ty])),
642        );
643        compute_applicable_impls_for_diagnostics(&infcx, &obligation, true).iter().any(
644            |candidate_source| {
645                matches!(
646                    candidate_source,
647                    &CandidateSource::DefId(def_id)
648                    if find_attr!(tcx, def_id, AutomaticallyDerived)
649                )
650            },
651        )
652    };
653
654    let possibly_inapplicable_structural_partial_eq = {
655        let obligation = Obligation::new(
656            tcx,
657            ObligationCause::dummy(),
658            param_env,
659            ty::Binder::dummy(ty::TraitRef::new(tcx, structural_partial_eq_trait_id, [ty])),
660        );
661        compute_applicable_impls_for_diagnostics(&infcx, &obligation, true)
662            .iter()
663            .any(|candidate_source| matches!(candidate_source, CandidateSource::DefId(_)))
664    };
665
666    let mut automatically_derived = false;
667    let mut impl_def_id = None;
668    for def_id in tcx.non_blanket_impls_for_ty(partial_eq_trait_id, ty) {
669        automatically_derived = find_attr!(tcx, def_id, AutomaticallyDerived);
670        impl_def_id = Some(def_id);
671    }
672
673    PartialEqImplStatus {
674        has_impl,
675        is_derived: automatically_derived,
676        possibly_inapplicable_structural_partial_eq,
677        non_blanket_impl: impl_def_id,
678        possibly_inapplicable_derived_partial_eq,
679    }
680}