1 //! Type checking expressions.
3 //! See `mod.rs` for more context on type checking in general.
6 use crate::coercion::CoerceMany;
7 use crate::coercion::DynamicCoerceMany;
8 use crate::errors::TypeMismatchFruTypo;
9 use crate::errors::{AddressOfTemporaryTaken, ReturnStmtOutsideOfFnBody, StructExprNonExhaustive};
11 FieldMultiplySpecifiedInInitializer, FunctionalRecordUpdateOnNonStruct, HelpUseLatestEdition,
12 YieldExprOutsideOfGenerator,
14 use crate::fatally_break_rust;
15 use crate::method::SelfSource;
16 use crate::type_error_struct;
17 use crate::Expectation::{self, ExpectCastableToType, ExpectHasType, NoExpectation};
19 report_unexpected_variant_res, BreakableCtxt, Diverges, FnCtxt, Needs,
20 TupleArgumentsFlag::DontTupleArguments,
23 use rustc_data_structures::fx::FxHashMap;
24 use rustc_data_structures::stack::ensure_sufficient_stack;
26 pluralize, struct_span_err, AddToDiagnostic, Applicability, Diagnostic, DiagnosticBuilder,
27 DiagnosticId, ErrorGuaranteed, StashKey,
30 use rustc_hir::def::{CtorKind, DefKind, Res};
31 use rustc_hir::def_id::DefId;
32 use rustc_hir::intravisit::Visitor;
33 use rustc_hir::lang_items::LangItem;
34 use rustc_hir::{ExprKind, HirId, QPath};
35 use rustc_hir_analysis::astconv::AstConv as _;
36 use rustc_hir_analysis::check::ty_kind_suggestion;
37 use rustc_infer::infer;
38 use rustc_infer::infer::type_variable::{TypeVariableOrigin, TypeVariableOriginKind};
39 use rustc_infer::infer::InferOk;
40 use rustc_infer::traits::ObligationCause;
41 use rustc_middle::middle::stability;
42 use rustc_middle::ty::adjustment::{Adjust, Adjustment, AllowTwoPhase};
43 use rustc_middle::ty::error::TypeError::FieldMisMatch;
44 use rustc_middle::ty::subst::SubstsRef;
45 use rustc_middle::ty::{self, AdtKind, Ty, TypeVisitable};
46 use rustc_session::errors::ExprParenthesesNeeded;
47 use rustc_session::parse::feature_err;
48 use rustc_span::hygiene::DesugaringKind;
49 use rustc_span::lev_distance::find_best_match_for_name;
50 use rustc_span::source_map::{Span, Spanned};
51 use rustc_span::symbol::{kw, sym, Ident, Symbol};
52 use rustc_target::spec::abi::Abi::RustIntrinsic;
53 use rustc_trait_selection::infer::InferCtxtExt;
54 use rustc_trait_selection::traits::{self, ObligationCauseCode};
56 impl<'a, 'tcx> FnCtxt<'a, 'tcx> {
57 fn check_expr_eq_type(&self, expr: &'tcx hir::Expr<'tcx>, expected: Ty<'tcx>) {
58 let ty = self.check_expr_with_hint(expr, expected);
59 self.demand_eqtype(expr.span, expected, ty);
62 pub fn check_expr_has_type_or_error(
64 expr: &'tcx hir::Expr<'tcx>,
66 extend_err: impl FnMut(&mut Diagnostic),
68 self.check_expr_meets_expectation_or_error(expr, ExpectHasType(expected), extend_err)
71 fn check_expr_meets_expectation_or_error(
73 expr: &'tcx hir::Expr<'tcx>,
74 expected: Expectation<'tcx>,
75 mut extend_err: impl FnMut(&mut Diagnostic),
77 let expected_ty = expected.to_option(&self).unwrap_or(self.tcx.types.bool);
78 let mut ty = self.check_expr_with_expectation(expr, expected);
80 // While we don't allow *arbitrary* coercions here, we *do* allow
81 // coercions from ! to `expected`.
83 if let Some(adjustments) = self.typeck_results.borrow().adjustments().get(expr.hir_id) {
84 let reported = self.tcx().sess.delay_span_bug(
86 "expression with never type wound up being adjusted",
88 return if let [Adjustment { kind: Adjust::NeverToAny, target }] = &adjustments[..] {
91 self.tcx().ty_error_with_guaranteed(reported)
95 let adj_ty = self.next_ty_var(TypeVariableOrigin {
96 kind: TypeVariableOriginKind::AdjustmentType,
99 self.apply_adjustments(
101 vec![Adjustment { kind: Adjust::NeverToAny, target: adj_ty }],
106 if let Some(mut err) = self.demand_suptype_diag(expr.span, expected_ty, ty) {
107 let _ = self.emit_type_mismatch_suggestions(
109 expr.peel_drop_temps(),
115 extend_err(&mut err);
121 pub(super) fn check_expr_coercable_to_type(
123 expr: &'tcx hir::Expr<'tcx>,
125 expected_ty_expr: Option<&'tcx hir::Expr<'tcx>>,
127 let ty = self.check_expr_with_hint(expr, expected);
128 // checks don't need two phase
129 self.demand_coerce(expr, ty, expected, expected_ty_expr, AllowTwoPhase::No)
132 pub(super) fn check_expr_with_hint(
134 expr: &'tcx hir::Expr<'tcx>,
137 self.check_expr_with_expectation(expr, ExpectHasType(expected))
140 fn check_expr_with_expectation_and_needs(
142 expr: &'tcx hir::Expr<'tcx>,
143 expected: Expectation<'tcx>,
146 let ty = self.check_expr_with_expectation(expr, expected);
148 // If the expression is used in a place whether mutable place is required
149 // e.g. LHS of assignment, perform the conversion.
150 if let Needs::MutPlace = needs {
151 self.convert_place_derefs_to_mutable(expr);
157 pub(super) fn check_expr(&self, expr: &'tcx hir::Expr<'tcx>) -> Ty<'tcx> {
158 self.check_expr_with_expectation(expr, NoExpectation)
161 pub(super) fn check_expr_with_needs(
163 expr: &'tcx hir::Expr<'tcx>,
166 self.check_expr_with_expectation_and_needs(expr, NoExpectation, needs)
170 /// If an expression has any sub-expressions that result in a type error,
171 /// inspecting that expression's type with `ty.references_error()` will return
172 /// true. Likewise, if an expression is known to diverge, inspecting its
173 /// type with `ty::type_is_bot` will return true (n.b.: since Rust is
174 /// strict, _|_ can appear in the type of an expression that does not,
175 /// itself, diverge: for example, fn() -> _|_.)
176 /// Note that inspecting a type's structure *directly* may expose the fact
177 /// that there are actually multiple representations for `Error`, so avoid
178 /// that when err needs to be handled differently.
179 #[instrument(skip(self, expr), level = "debug")]
180 pub(super) fn check_expr_with_expectation(
182 expr: &'tcx hir::Expr<'tcx>,
183 expected: Expectation<'tcx>,
185 self.check_expr_with_expectation_and_args(expr, expected, &[])
188 /// Same as `check_expr_with_expectation`, but allows us to pass in the arguments of a
189 /// `ExprKind::Call` when evaluating its callee when it is an `ExprKind::Path`.
190 pub(super) fn check_expr_with_expectation_and_args(
192 expr: &'tcx hir::Expr<'tcx>,
193 expected: Expectation<'tcx>,
194 args: &'tcx [hir::Expr<'tcx>],
196 if self.tcx().sess.verbose() {
197 // make this code only run with -Zverbose because it is probably slow
198 if let Ok(lint_str) = self.tcx.sess.source_map().span_to_snippet(expr.span) {
199 if !lint_str.contains('\n') {
200 debug!("expr text: {lint_str}");
202 let mut lines = lint_str.lines();
203 if let Some(line0) = lines.next() {
204 let remaining_lines = lines.count();
205 debug!("expr text: {line0}");
206 debug!("expr text: ...(and {remaining_lines} more lines)");
212 // True if `expr` is a `Try::from_ok(())` that is a result of desugaring a try block
213 // without the final expr (e.g. `try { return; }`). We don't want to generate an
214 // unreachable_code lint for it since warnings for autogenerated code are confusing.
215 let is_try_block_generated_unit_expr = match expr.kind {
216 ExprKind::Call(_, args) if expr.span.is_desugaring(DesugaringKind::TryBlock) => {
217 args.len() == 1 && args[0].span.is_desugaring(DesugaringKind::TryBlock)
223 // Warn for expressions after diverging siblings.
224 if !is_try_block_generated_unit_expr {
225 self.warn_if_unreachable(expr.hir_id, expr.span, "expression");
228 // Hide the outer diverging and has_errors flags.
229 let old_diverges = self.diverges.replace(Diverges::Maybe);
231 let ty = ensure_sufficient_stack(|| match &expr.kind {
233 qpath @ hir::QPath::Resolved(..) | qpath @ hir::QPath::TypeRelative(..),
234 ) => self.check_expr_path(qpath, expr, args),
235 _ => self.check_expr_kind(expr, expected),
237 let ty = self.resolve_vars_if_possible(ty);
239 // Warn for non-block expressions with diverging children.
245 | ExprKind::Match(..) => {}
246 // If `expr` is a result of desugaring the try block and is an ok-wrapped
247 // diverging expression (e.g. it arose from desugaring of `try { return }`),
248 // we skip issuing a warning because it is autogenerated code.
249 ExprKind::Call(..) if expr.span.is_desugaring(DesugaringKind::TryBlock) => {}
250 ExprKind::Call(callee, _) => self.warn_if_unreachable(expr.hir_id, callee.span, "call"),
251 ExprKind::MethodCall(segment, ..) => {
252 self.warn_if_unreachable(expr.hir_id, segment.ident.span, "call")
254 _ => self.warn_if_unreachable(expr.hir_id, expr.span, "expression"),
257 // Any expression that produces a value of type `!` must have diverged
259 self.diverges.set(self.diverges.get() | Diverges::always(expr.span));
262 // Record the type, which applies it effects.
263 // We need to do this after the warning above, so that
264 // we don't warn for the diverging expression itself.
265 self.write_ty(expr.hir_id, ty);
267 // Combine the diverging and has_error flags.
268 self.diverges.set(self.diverges.get() | old_diverges);
270 debug!("type of {} is...", self.tcx.hir().node_to_string(expr.hir_id));
271 debug!("... {:?}, expected is {:?}", ty, expected);
276 #[instrument(skip(self, expr), level = "debug")]
279 expr: &'tcx hir::Expr<'tcx>,
280 expected: Expectation<'tcx>,
282 trace!("expr={:#?}", expr);
286 ExprKind::Box(subexpr) => self.check_expr_box(subexpr, expected),
287 ExprKind::Lit(ref lit) => self.check_lit(&lit, expected),
288 ExprKind::Binary(op, lhs, rhs) => self.check_binop(expr, op, lhs, rhs, expected),
289 ExprKind::Assign(lhs, rhs, span) => {
290 self.check_expr_assign(expr, expected, lhs, rhs, span)
292 ExprKind::AssignOp(op, lhs, rhs) => {
293 self.check_binop_assign(expr, op, lhs, rhs, expected)
295 ExprKind::Unary(unop, oprnd) => self.check_expr_unary(unop, oprnd, expected, expr),
296 ExprKind::AddrOf(kind, mutbl, oprnd) => {
297 self.check_expr_addr_of(kind, mutbl, oprnd, expected, expr)
299 ExprKind::Path(QPath::LangItem(lang_item, _, hir_id)) => {
300 self.check_lang_item_path(lang_item, expr, hir_id)
302 ExprKind::Path(ref qpath) => self.check_expr_path(qpath, expr, &[]),
303 ExprKind::InlineAsm(asm) => {
304 // We defer some asm checks as we may not have resolved the input and output types yet (they may still be infer vars).
305 self.deferred_asm_checks.borrow_mut().push((asm, expr.hir_id));
306 self.check_expr_asm(asm)
308 ExprKind::Break(destination, ref expr_opt) => {
309 self.check_expr_break(destination, expr_opt.as_deref(), expr)
311 ExprKind::Continue(destination) => {
312 if destination.target_id.is_ok() {
315 // There was an error; make type-check fail.
319 ExprKind::Ret(ref expr_opt) => self.check_expr_return(expr_opt.as_deref(), expr),
320 ExprKind::Let(let_expr) => self.check_expr_let(let_expr),
321 ExprKind::Loop(body, _, source, _) => {
322 self.check_expr_loop(body, source, expected, expr)
324 ExprKind::Match(discrim, arms, match_src) => {
325 self.check_match(expr, &discrim, arms, expected, match_src)
327 ExprKind::Closure(closure) => self.check_expr_closure(closure, expr.span, expected),
328 ExprKind::Block(body, _) => self.check_block_with_expected(&body, expected),
329 ExprKind::Call(callee, args) => self.check_call(expr, &callee, args, expected),
330 ExprKind::MethodCall(segment, receiver, args, _) => {
331 self.check_method_call(expr, segment, receiver, args, expected)
333 ExprKind::Cast(e, t) => self.check_expr_cast(e, t, expr),
334 ExprKind::Type(e, t) => {
335 let ty = self.to_ty_saving_user_provided_ty(&t);
336 self.check_expr_eq_type(&e, ty);
339 ExprKind::If(cond, then_expr, opt_else_expr) => {
340 self.check_then_else(cond, then_expr, opt_else_expr, expr.span, expected)
342 ExprKind::DropTemps(e) => self.check_expr_with_expectation(e, expected),
343 ExprKind::Array(args) => self.check_expr_array(args, expected, expr),
344 ExprKind::ConstBlock(ref anon_const) => {
345 self.check_expr_const_block(anon_const, expected, expr)
347 ExprKind::Repeat(element, ref count) => {
348 self.check_expr_repeat(element, count, expected, expr)
350 ExprKind::Tup(elts) => self.check_expr_tuple(elts, expected, expr),
351 ExprKind::Struct(qpath, fields, ref base_expr) => {
352 self.check_expr_struct(expr, expected, qpath, fields, base_expr)
354 ExprKind::Field(base, field) => self.check_field(expr, &base, field, expected),
355 ExprKind::Index(base, idx) => self.check_expr_index(base, idx, expr),
356 ExprKind::Yield(value, ref src) => self.check_expr_yield(value, expr, src),
357 hir::ExprKind::Err => tcx.ty_error(),
361 fn check_expr_box(&self, expr: &'tcx hir::Expr<'tcx>, expected: Expectation<'tcx>) -> Ty<'tcx> {
362 let expected_inner = expected.to_option(self).map_or(NoExpectation, |ty| match ty.kind() {
363 ty::Adt(def, _) if def.is_box() => Expectation::rvalue_hint(self, ty.boxed_ty()),
366 let referent_ty = self.check_expr_with_expectation(expr, expected_inner);
367 self.require_type_is_sized(referent_ty, expr.span, traits::SizedBoxType);
368 self.tcx.mk_box(referent_ty)
374 oprnd: &'tcx hir::Expr<'tcx>,
375 expected: Expectation<'tcx>,
376 expr: &'tcx hir::Expr<'tcx>,
379 let expected_inner = match unop {
380 hir::UnOp::Not | hir::UnOp::Neg => expected,
381 hir::UnOp::Deref => NoExpectation,
383 let mut oprnd_t = self.check_expr_with_expectation(&oprnd, expected_inner);
385 if !oprnd_t.references_error() {
386 oprnd_t = self.structurally_resolved_type(expr.span, oprnd_t);
388 hir::UnOp::Deref => {
389 if let Some(ty) = self.lookup_derefing(expr, oprnd, oprnd_t) {
392 let mut err = type_error_struct!(
397 "type `{oprnd_t}` cannot be dereferenced",
399 let sp = tcx.sess.source_map().start_point(expr.span).with_parent(None);
401 tcx.sess.parse_sess.ambiguous_block_expr_parse.borrow().get(&sp)
403 err.subdiagnostic(ExprParenthesesNeeded::surrounding(*sp));
405 oprnd_t = tcx.ty_error_with_guaranteed(err.emit());
409 let result = self.check_user_unop(expr, oprnd_t, unop, expected_inner);
410 // If it's builtin, we can reuse the type, this helps inference.
411 if !(oprnd_t.is_integral() || *oprnd_t.kind() == ty::Bool) {
416 let result = self.check_user_unop(expr, oprnd_t, unop, expected_inner);
417 // If it's builtin, we can reuse the type, this helps inference.
418 if !oprnd_t.is_numeric() {
427 fn check_expr_addr_of(
429 kind: hir::BorrowKind,
430 mutbl: hir::Mutability,
431 oprnd: &'tcx hir::Expr<'tcx>,
432 expected: Expectation<'tcx>,
433 expr: &'tcx hir::Expr<'tcx>,
435 let hint = expected.only_has_type(self).map_or(NoExpectation, |ty| {
437 ty::Ref(_, ty, _) | ty::RawPtr(ty::TypeAndMut { ty, .. }) => {
438 if oprnd.is_syntactic_place_expr() {
439 // Places may legitimately have unsized types.
440 // For example, dereferences of a fat pointer and
441 // the last field of a struct can be unsized.
444 Expectation::rvalue_hint(self, *ty)
451 self.check_expr_with_expectation_and_needs(&oprnd, hint, Needs::maybe_mut_place(mutbl));
453 let tm = ty::TypeAndMut { ty, mutbl };
455 _ if tm.ty.references_error() => self.tcx.ty_error(),
456 hir::BorrowKind::Raw => {
457 self.check_named_place_expr(oprnd);
460 hir::BorrowKind::Ref => {
461 // Note: at this point, we cannot say what the best lifetime
462 // is to use for resulting pointer. We want to use the
463 // shortest lifetime possible so as to avoid spurious borrowck
464 // errors. Moreover, the longest lifetime will depend on the
465 // precise details of the value whose address is being taken
466 // (and how long it is valid), which we don't know yet until
467 // type inference is complete.
469 // Therefore, here we simply generate a region variable. The
470 // region inferencer will then select a suitable value.
471 // Finally, borrowck will infer the value of the region again,
472 // this time with enough precision to check that the value
473 // whose address was taken can actually be made to live as long
474 // as it needs to live.
475 let region = self.next_region_var(infer::AddrOfRegion(expr.span));
476 self.tcx.mk_ref(region, tm)
481 /// Does this expression refer to a place that either:
482 /// * Is based on a local or static.
483 /// * Contains a dereference
484 /// Note that the adjustments for the children of `expr` should already
485 /// have been resolved.
486 fn check_named_place_expr(&self, oprnd: &'tcx hir::Expr<'tcx>) {
487 let is_named = oprnd.is_place_expr(|base| {
488 // Allow raw borrows if there are any deref adjustments.
490 // const VAL: (i32,) = (0,);
491 // const REF: &(i32,) = &(0,);
493 // &raw const VAL.0; // ERROR
494 // &raw const REF.0; // OK, same as &raw const (*REF).0;
496 // This is maybe too permissive, since it allows
497 // `let u = &raw const Box::new((1,)).0`, which creates an
498 // immediately dangling raw pointer.
503 .map_or(false, |x| x.iter().any(|adj| matches!(adj.kind, Adjust::Deref(_))))
506 self.tcx.sess.emit_err(AddressOfTemporaryTaken { span: oprnd.span });
510 fn check_lang_item_path(
512 lang_item: hir::LangItem,
513 expr: &'tcx hir::Expr<'tcx>,
514 hir_id: Option<hir::HirId>,
516 self.resolve_lang_item_path(lang_item, expr.span, expr.hir_id, hir_id).1
519 pub(crate) fn check_expr_path(
521 qpath: &'tcx hir::QPath<'tcx>,
522 expr: &'tcx hir::Expr<'tcx>,
523 args: &'tcx [hir::Expr<'tcx>],
526 let (res, opt_ty, segs) =
527 self.resolve_ty_and_res_fully_qualified_call(qpath, expr.hir_id, expr.span);
530 self.suggest_assoc_method_call(segs);
532 self.tcx.sess.delay_span_bug(qpath.span(), "`Res::Err` but no error emitted");
533 self.set_tainted_by_errors(e);
534 tcx.ty_error_with_guaranteed(e)
536 Res::Def(DefKind::Variant, _) => {
537 let e = report_unexpected_variant_res(tcx, res, qpath, expr.span, "E0533", "value");
538 tcx.ty_error_with_guaranteed(e)
540 _ => self.instantiate_value_path(segs, opt_ty, res, expr.span, expr.hir_id).0,
543 if let ty::FnDef(did, ..) = *ty.kind() {
544 let fn_sig = ty.fn_sig(tcx);
545 if tcx.fn_sig(did).skip_binder().abi() == RustIntrinsic
546 && tcx.item_name(did) == sym::transmute
548 let from = fn_sig.inputs().skip_binder()[0];
549 let to = fn_sig.output().skip_binder();
550 // We defer the transmute to the end of typeck, once all inference vars have
551 // been resolved or we errored. This is important as we can only check transmute
552 // on concrete types, but the output type may not be known yet (it would only
553 // be known if explicitly specified via turbofish).
554 self.deferred_transmute_checks.borrow_mut().push((from, to, expr.hir_id));
556 if !tcx.features().unsized_fn_params {
557 // We want to remove some Sized bounds from std functions,
558 // but don't want to expose the removal to stable Rust.
559 // i.e., we don't want to allow
565 // to work in stable even if the Sized bound on `drop` is relaxed.
566 for i in 0..fn_sig.inputs().skip_binder().len() {
567 // We just want to check sizedness, so instead of introducing
568 // placeholder lifetimes with probing, we just replace higher lifetimes
570 let span = args.get(i).map(|a| a.span).unwrap_or(expr.span);
571 let input = self.replace_bound_vars_with_fresh_vars(
573 infer::LateBoundRegionConversionTime::FnCall,
576 self.require_type_is_sized_deferred(
579 traits::SizedArgumentType(None),
583 // Here we want to prevent struct constructors from returning unsized types.
584 // There were two cases this happened: fn pointer coercion in stable
585 // and usual function call in presence of unsized_locals.
586 // Also, as we just want to check sizedness, instead of introducing
587 // placeholder lifetimes with probing, we just replace higher lifetimes
589 let output = self.replace_bound_vars_with_fresh_vars(
591 infer::LateBoundRegionConversionTime::FnCall,
594 self.require_type_is_sized_deferred(output, expr.span, traits::SizedReturnType);
597 // We always require that the type provided as the value for
598 // a type parameter outlives the moment of instantiation.
599 let substs = self.typeck_results.borrow().node_substs(expr.hir_id);
600 self.add_wf_bounds(substs, expr);
607 destination: hir::Destination,
608 expr_opt: Option<&'tcx hir::Expr<'tcx>>,
609 expr: &'tcx hir::Expr<'tcx>,
612 if let Ok(target_id) = destination.target_id {
614 if let Some(e) = expr_opt {
615 // If this is a break with a value, we need to type-check
616 // the expression. Get an expected type from the loop context.
617 let opt_coerce_to = {
618 // We should release `enclosing_breakables` before the `check_expr_with_hint`
619 // below, so can't move this block of code to the enclosing scope and share
620 // `ctxt` with the second `enclosing_breakables` borrow below.
621 let mut enclosing_breakables = self.enclosing_breakables.borrow_mut();
622 match enclosing_breakables.opt_find_breakable(target_id) {
623 Some(ctxt) => ctxt.coerce.as_ref().map(|coerce| coerce.expected_ty()),
625 // Avoid ICE when `break` is inside a closure (#65383).
626 return tcx.ty_error_with_message(
628 "break was outside loop, but no error was emitted",
634 // If the loop context is not a `loop { }`, then break with
635 // a value is illegal, and `opt_coerce_to` will be `None`.
636 // Just set expectation to error in that case.
637 let coerce_to = opt_coerce_to.unwrap_or_else(|| tcx.ty_error());
639 // Recurse without `enclosing_breakables` borrowed.
640 e_ty = self.check_expr_with_hint(e, coerce_to);
641 cause = self.misc(e.span);
643 // Otherwise, this is a break *without* a value. That's
644 // always legal, and is equivalent to `break ()`.
645 e_ty = tcx.mk_unit();
646 cause = self.misc(expr.span);
649 // Now that we have type-checked `expr_opt`, borrow
650 // the `enclosing_loops` field and let's coerce the
651 // type of `expr_opt` into what is expected.
652 let mut enclosing_breakables = self.enclosing_breakables.borrow_mut();
653 let Some(ctxt) = enclosing_breakables.opt_find_breakable(target_id) else {
654 // Avoid ICE when `break` is inside a closure (#65383).
655 return tcx.ty_error_with_message(
657 "break was outside loop, but no error was emitted",
661 if let Some(ref mut coerce) = ctxt.coerce {
662 if let Some(ref e) = expr_opt {
663 coerce.coerce(self, &cause, e, e_ty);
665 assert!(e_ty.is_unit());
666 let ty = coerce.expected_ty();
667 coerce.coerce_forced_unit(
671 self.suggest_mismatched_types_on_tail(
672 &mut err, expr, ty, e_ty, target_id,
674 if let Some(val) = ty_kind_suggestion(ty) {
675 let label = destination
677 .map(|l| format!(" {}", l.ident))
678 .unwrap_or_else(String::new);
681 "give it a value of the expected type",
682 format!("break{label} {val}"),
683 Applicability::HasPlaceholders,
691 // If `ctxt.coerce` is `None`, we can just ignore
692 // the type of the expression. This is because
693 // either this was a break *without* a value, in
694 // which case it is always a legal type (`()`), or
695 // else an error would have been flagged by the
696 // `loops` pass for using break with an expression
697 // where you are not supposed to.
698 assert!(expr_opt.is_none() || self.tcx.sess.has_errors().is_some());
701 // If we encountered a `break`, then (no surprise) it may be possible to break from the
702 // loop... unless the value being returned from the loop diverges itself, e.g.
703 // `break return 5` or `break loop {}`.
704 ctxt.may_break |= !self.diverges.get().is_always();
706 // the type of a `break` is always `!`, since it diverges
709 // Otherwise, we failed to find the enclosing loop;
710 // this can only happen if the `break` was not
711 // inside a loop at all, which is caught by the
712 // loop-checking pass.
713 let err = self.tcx.ty_error_with_message(
715 "break was outside loop, but no error was emitted",
718 // We still need to assign a type to the inner expression to
719 // prevent the ICE in #43162.
720 if let Some(e) = expr_opt {
721 self.check_expr_with_hint(e, err);
723 // ... except when we try to 'break rust;'.
724 // ICE this expression in particular (see #43162).
725 if let ExprKind::Path(QPath::Resolved(_, path)) = e.kind {
726 if path.segments.len() == 1 && path.segments[0].ident.name == sym::rust {
727 fatally_break_rust(self.tcx.sess);
732 // There was an error; make type-check fail.
737 fn check_expr_return(
739 expr_opt: Option<&'tcx hir::Expr<'tcx>>,
740 expr: &'tcx hir::Expr<'tcx>,
742 if self.ret_coercion.is_none() {
743 let mut err = ReturnStmtOutsideOfFnBody {
745 encl_body_span: None,
749 let encl_item_id = self.tcx.hir().get_parent_item(expr.hir_id);
751 if let Some(hir::Node::Item(hir::Item {
752 kind: hir::ItemKind::Fn(..),
756 | Some(hir::Node::TraitItem(hir::TraitItem {
757 kind: hir::TraitItemKind::Fn(_, hir::TraitFn::Provided(_)),
761 | Some(hir::Node::ImplItem(hir::ImplItem {
762 kind: hir::ImplItemKind::Fn(..),
765 })) = self.tcx.hir().find_by_def_id(encl_item_id.def_id)
767 // We are inside a function body, so reporting "return statement
768 // outside of function body" needs an explanation.
770 let encl_body_owner_id = self.tcx.hir().enclosing_body_owner(expr.hir_id);
772 // If this didn't hold, we would not have to report an error in
774 assert_ne!(encl_item_id.def_id, encl_body_owner_id);
776 let encl_body_id = self.tcx.hir().body_owned_by(encl_body_owner_id);
777 let encl_body = self.tcx.hir().body(encl_body_id);
779 err.encl_body_span = Some(encl_body.value.span);
780 err.encl_fn_span = Some(*encl_fn_span);
783 self.tcx.sess.emit_err(err);
785 if let Some(e) = expr_opt {
786 // We still have to type-check `e` (issue #86188), but calling
787 // `check_return_expr` only works inside fn bodies.
790 } else if let Some(e) = expr_opt {
791 if self.ret_coercion_span.get().is_none() {
792 self.ret_coercion_span.set(Some(e.span));
794 self.check_return_expr(e, true);
796 let mut coercion = self.ret_coercion.as_ref().unwrap().borrow_mut();
797 if self.ret_coercion_span.get().is_none() {
798 self.ret_coercion_span.set(Some(expr.span));
800 let cause = self.cause(expr.span, ObligationCauseCode::ReturnNoExpression);
801 if let Some((fn_decl, _)) = self.get_fn_decl(expr.hir_id) {
802 coercion.coerce_forced_unit(
806 let span = fn_decl.output.span();
807 if let Ok(snippet) = self.tcx.sess.source_map().span_to_snippet(span) {
810 format!("expected `{snippet}` because of this return type"),
817 coercion.coerce_forced_unit(self, &cause, &mut |_| (), true);
823 /// `explicit_return` is `true` if we're checking an explicit `return expr`,
824 /// and `false` if we're checking a trailing expression.
825 pub(super) fn check_return_expr(
827 return_expr: &'tcx hir::Expr<'tcx>,
828 explicit_return: bool,
830 let ret_coercion = self.ret_coercion.as_ref().unwrap_or_else(|| {
831 span_bug!(return_expr.span, "check_return_expr called outside fn body")
834 let ret_ty = ret_coercion.borrow().expected_ty();
835 let return_expr_ty = self.check_expr_with_hint(return_expr, ret_ty);
836 let mut span = return_expr.span;
837 // Use the span of the trailing expression for our cause,
838 // not the span of the entire function
839 if !explicit_return {
840 if let ExprKind::Block(body, _) = return_expr.kind && let Some(last_expr) = body.expr {
841 span = last_expr.span;
844 ret_coercion.borrow_mut().coerce(
846 &self.cause(span, ObligationCauseCode::ReturnValue(return_expr.hir_id)),
851 if let Some(fn_sig) = self.body_fn_sig()
852 && fn_sig.output().has_opaque_types()
854 // Point any obligations that were registered due to opaque type
855 // inference at the return expression.
856 self.select_obligations_where_possible(|errors| {
857 self.point_at_return_for_opaque_ty_error(errors, span, return_expr_ty, return_expr.span);
862 fn point_at_return_for_opaque_ty_error(
864 errors: &mut Vec<traits::FulfillmentError<'tcx>>,
866 return_expr_ty: Ty<'tcx>,
869 // Don't point at the whole block if it's empty
870 if span == return_span {
874 let cause = &mut err.obligation.cause;
875 if let ObligationCauseCode::OpaqueReturnType(None) = cause.code() {
876 let new_cause = ObligationCause::new(
879 ObligationCauseCode::OpaqueReturnType(Some((return_expr_ty, span))),
886 pub(crate) fn check_lhs_assignable(
888 lhs: &'tcx hir::Expr<'tcx>,
889 err_code: &'static str,
891 adjust_err: impl FnOnce(&mut Diagnostic),
893 if lhs.is_syntactic_place_expr() {
897 // FIXME: Make this use Diagnostic once error codes can be dynamically set.
898 let mut err = self.tcx.sess.struct_span_err_with_code(
900 "invalid left-hand side of assignment",
901 DiagnosticId::Error(err_code.into()),
903 err.span_label(lhs.span, "cannot assign to this expression");
905 self.comes_from_while_condition(lhs.hir_id, |expr| {
906 err.span_suggestion_verbose(
907 expr.span.shrink_to_lo(),
908 "you might have meant to use pattern destructuring",
910 Applicability::MachineApplicable,
914 adjust_err(&mut err);
919 // Check if an expression `original_expr_id` comes from the condition of a while loop,
920 /// as opposed from the body of a while loop, which we can naively check by iterating
921 /// parents until we find a loop...
922 pub(super) fn comes_from_while_condition(
924 original_expr_id: HirId,
925 then: impl FnOnce(&hir::Expr<'_>),
927 let mut parent = self.tcx.hir().parent_id(original_expr_id);
928 while let Some(node) = self.tcx.hir().find(parent) {
930 hir::Node::Expr(hir::Expr {
937 hir::ExprKind::Match(expr, ..) | hir::ExprKind::If(expr, ..),
943 hir::LoopSource::While,
948 // Check if our original expression is a child of the condition of a while loop
949 let expr_is_ancestor = std::iter::successors(Some(original_expr_id), |id| {
950 self.tcx.hir().opt_parent_id(*id)
952 .take_while(|id| *id != parent)
953 .any(|id| id == expr.hir_id);
954 // if it is, then we have a situation like `while Some(0) = value.get(0) {`,
955 // where `while let` was more likely intended.
956 if expr_is_ancestor {
962 | hir::Node::ImplItem(_)
963 | hir::Node::TraitItem(_)
964 | hir::Node::Crate(_) => break,
966 parent = self.tcx.hir().parent_id(parent);
972 // A generic function for checking the 'then' and 'else' clauses in an 'if'
973 // or 'if-else' expression.
976 cond_expr: &'tcx hir::Expr<'tcx>,
977 then_expr: &'tcx hir::Expr<'tcx>,
978 opt_else_expr: Option<&'tcx hir::Expr<'tcx>>,
980 orig_expected: Expectation<'tcx>,
982 let cond_ty = self.check_expr_has_type_or_error(cond_expr, self.tcx.types.bool, |_| {});
984 self.warn_if_unreachable(
987 "block in `if` or `while` expression",
990 let cond_diverges = self.diverges.get();
991 self.diverges.set(Diverges::Maybe);
993 let expected = orig_expected.adjust_for_branches(self);
994 let then_ty = self.check_expr_with_expectation(then_expr, expected);
995 let then_diverges = self.diverges.get();
996 self.diverges.set(Diverges::Maybe);
998 // We've already taken the expected type's preferences
999 // into account when typing the `then` branch. To figure
1000 // out the initial shot at a LUB, we thus only consider
1001 // `expected` if it represents a *hard* constraint
1002 // (`only_has_type`); otherwise, we just go with a
1003 // fresh type variable.
1004 let coerce_to_ty = expected.coercion_target_type(self, sp);
1005 let mut coerce: DynamicCoerceMany<'_> = CoerceMany::new(coerce_to_ty);
1007 coerce.coerce(self, &self.misc(sp), then_expr, then_ty);
1009 if let Some(else_expr) = opt_else_expr {
1010 let else_ty = self.check_expr_with_expectation(else_expr, expected);
1011 let else_diverges = self.diverges.get();
1013 let opt_suggest_box_span = self.opt_suggest_box_span(then_ty, else_ty, orig_expected);
1014 let if_cause = self.if_cause(
1021 opt_suggest_box_span,
1024 coerce.coerce(self, &if_cause, else_expr, else_ty);
1026 // We won't diverge unless both branches do (or the condition does).
1027 self.diverges.set(cond_diverges | then_diverges & else_diverges);
1029 self.if_fallback_coercion(sp, then_expr, &mut coerce);
1031 // If the condition is false we can't diverge.
1032 self.diverges.set(cond_diverges);
1035 let result_ty = coerce.complete(self);
1036 if cond_ty.references_error() { self.tcx.ty_error() } else { result_ty }
1039 /// Type check assignment expression `expr` of form `lhs = rhs`.
1040 /// The expected type is `()` and is passed to the function for the purposes of diagnostics.
1041 fn check_expr_assign(
1043 expr: &'tcx hir::Expr<'tcx>,
1044 expected: Expectation<'tcx>,
1045 lhs: &'tcx hir::Expr<'tcx>,
1046 rhs: &'tcx hir::Expr<'tcx>,
1049 let expected_ty = expected.coercion_target_type(self, expr.span);
1050 if expected_ty == self.tcx.types.bool {
1051 // The expected type is `bool` but this will result in `()` so we can reasonably
1052 // say that the user intended to write `lhs == rhs` instead of `lhs = rhs`.
1053 // The likely cause of this is `if foo = bar { .. }`.
1054 let actual_ty = self.tcx.mk_unit();
1055 let mut err = self.demand_suptype_diag(expr.span, expected_ty, actual_ty).unwrap();
1056 let lhs_ty = self.check_expr(&lhs);
1057 let rhs_ty = self.check_expr(&rhs);
1058 let (applicability, eq) = if self.can_coerce(rhs_ty, lhs_ty) {
1059 (Applicability::MachineApplicable, true)
1060 } else if let ExprKind::Binary(
1061 Spanned { node: hir::BinOpKind::And | hir::BinOpKind::Or, .. },
1066 // if x == 1 && y == 2 { .. }
1068 let actual_lhs_ty = self.check_expr(&rhs_expr);
1069 (Applicability::MaybeIncorrect, self.can_coerce(rhs_ty, actual_lhs_ty))
1070 } else if let ExprKind::Binary(
1071 Spanned { node: hir::BinOpKind::And | hir::BinOpKind::Or, .. },
1076 // if x == 1 && y == 2 { .. }
1078 let actual_rhs_ty = self.check_expr(&lhs_expr);
1079 (Applicability::MaybeIncorrect, self.can_coerce(actual_rhs_ty, lhs_ty))
1081 (Applicability::MaybeIncorrect, false)
1083 if !lhs.is_syntactic_place_expr()
1084 && lhs.is_approximately_pattern()
1085 && !matches!(lhs.kind, hir::ExprKind::Lit(_))
1087 // Do not suggest `if let x = y` as `==` is way more likely to be the intention.
1088 let hir = self.tcx.hir();
1089 if let hir::Node::Expr(hir::Expr { kind: ExprKind::If { .. }, .. }) =
1090 hir.get_parent(hir.parent_id(expr.hir_id))
1092 err.span_suggestion_verbose(
1093 expr.span.shrink_to_lo(),
1094 "you might have meant to use pattern matching",
1101 err.span_suggestion_verbose(
1102 span.shrink_to_hi(),
1103 "you might have meant to compare for equality",
1109 // If the assignment expression itself is ill-formed, don't
1110 // bother emitting another error
1111 let reported = err.emit_unless(lhs_ty.references_error() || rhs_ty.references_error());
1112 return self.tcx.ty_error_with_guaranteed(reported);
1115 let lhs_ty = self.check_expr_with_needs(&lhs, Needs::MutPlace);
1117 let suggest_deref_binop = |err: &mut Diagnostic, rhs_ty: Ty<'tcx>| {
1118 if let Some(lhs_deref_ty) = self.deref_once_mutably_for_diagnostic(lhs_ty) {
1119 // Can only assign if the type is sized, so if `DerefMut` yields a type that is
1120 // unsized, do not suggest dereferencing it.
1121 let lhs_deref_ty_is_sized = self
1123 .type_implements_trait(
1124 self.tcx.require_lang_item(LangItem::Sized, None),
1129 if lhs_deref_ty_is_sized && self.can_coerce(rhs_ty, lhs_deref_ty) {
1130 err.span_suggestion_verbose(
1131 lhs.span.shrink_to_lo(),
1132 "consider dereferencing here to assign to the mutably borrowed value",
1134 Applicability::MachineApplicable,
1140 // This is (basically) inlined `check_expr_coercable_to_type`, but we want
1141 // to suggest an additional fixup here in `suggest_deref_binop`.
1142 let rhs_ty = self.check_expr_with_hint(&rhs, lhs_ty);
1143 if let (_, Some(mut diag)) =
1144 self.demand_coerce_diag(rhs, rhs_ty, lhs_ty, Some(lhs), AllowTwoPhase::No)
1146 suggest_deref_binop(&mut diag, rhs_ty);
1150 self.check_lhs_assignable(lhs, "E0070", span, |err| {
1151 if let Some(rhs_ty) = self.typeck_results.borrow().expr_ty_opt(rhs) {
1152 suggest_deref_binop(err, rhs_ty);
1156 self.require_type_is_sized(lhs_ty, lhs.span, traits::AssignmentLhsSized);
1158 if lhs_ty.references_error() || rhs_ty.references_error() {
1165 pub(super) fn check_expr_let(&self, let_expr: &'tcx hir::Let<'tcx>) -> Ty<'tcx> {
1166 // for let statements, this is done in check_stmt
1167 let init = let_expr.init;
1168 self.warn_if_unreachable(init.hir_id, init.span, "block in `let` expression");
1169 // otherwise check exactly as a let statement
1170 self.check_decl(let_expr.into());
1171 // but return a bool, for this is a boolean expression
1177 body: &'tcx hir::Block<'tcx>,
1178 source: hir::LoopSource,
1179 expected: Expectation<'tcx>,
1180 expr: &'tcx hir::Expr<'tcx>,
1182 let coerce = match source {
1183 // you can only use break with a value from a normal `loop { }`
1184 hir::LoopSource::Loop => {
1185 let coerce_to = expected.coercion_target_type(self, body.span);
1186 Some(CoerceMany::new(coerce_to))
1189 hir::LoopSource::While | hir::LoopSource::ForLoop => None,
1192 let ctxt = BreakableCtxt {
1194 may_break: false, // Will get updated if/when we find a `break`.
1197 let (ctxt, ()) = self.with_breakable_ctxt(expr.hir_id, ctxt, || {
1198 self.check_block_no_value(&body);
1202 // No way to know whether it's diverging because
1203 // of a `break` or an outer `break` or `return`.
1204 self.diverges.set(Diverges::Maybe);
1207 // If we permit break with a value, then result type is
1208 // the LUB of the breaks (possibly ! if none); else, it
1209 // is nil. This makes sense because infinite loops
1210 // (which would have type !) are only possible iff we
1211 // permit break with a value [1].
1212 if ctxt.coerce.is_none() && !ctxt.may_break {
1214 self.tcx.sess.delay_span_bug(body.span, "no coercion, but loop may not break");
1216 ctxt.coerce.map(|c| c.complete(self)).unwrap_or_else(|| self.tcx.mk_unit())
1219 /// Checks a method call.
1220 fn check_method_call(
1222 expr: &'tcx hir::Expr<'tcx>,
1223 segment: &hir::PathSegment<'_>,
1224 rcvr: &'tcx hir::Expr<'tcx>,
1225 args: &'tcx [hir::Expr<'tcx>],
1226 expected: Expectation<'tcx>,
1228 let rcvr_t = self.check_expr(&rcvr);
1229 // no need to check for bot/err -- callee does that
1230 let rcvr_t = self.structurally_resolved_type(rcvr.span, rcvr_t);
1231 let span = segment.ident.span;
1233 let method = match self.lookup_method(rcvr_t, segment, span, expr, rcvr, args) {
1235 // We could add a "consider `foo::<params>`" suggestion here, but I wasn't able to
1236 // trigger this codepath causing `structurally_resolved_type` to emit an error.
1238 self.write_method_call(expr.hir_id, method);
1242 if segment.ident.name != kw::Empty {
1243 if let Some(mut err) = self.report_method_error(
1247 SelfSource::MethodCall(rcvr),
1259 // Call the generic checker.
1260 self.check_method_argument_types(span, expr, method, &args, DontTupleArguments, expected)
1265 e: &'tcx hir::Expr<'tcx>,
1266 t: &'tcx hir::Ty<'tcx>,
1267 expr: &'tcx hir::Expr<'tcx>,
1269 // Find the type of `e`. Supply hints based on the type we are casting to,
1271 let t_cast = self.to_ty_saving_user_provided_ty(t);
1272 let t_cast = self.resolve_vars_if_possible(t_cast);
1273 let t_expr = self.check_expr_with_expectation(e, ExpectCastableToType(t_cast));
1274 let t_expr = self.resolve_vars_if_possible(t_expr);
1276 // Eagerly check for some obvious errors.
1277 if t_expr.references_error() || t_cast.references_error() {
1280 // Defer other checks until we're done type checking.
1281 let mut deferred_cast_checks = self.deferred_cast_checks.borrow_mut();
1282 match cast::CastCheck::new(
1289 self.param_env.constness(),
1293 "check_expr_cast: deferring cast from {:?} to {:?}: {:?}",
1294 t_cast, t_expr, cast_check,
1296 deferred_cast_checks.push(cast_check);
1299 Err(_) => self.tcx.ty_error(),
1304 fn check_expr_array(
1306 args: &'tcx [hir::Expr<'tcx>],
1307 expected: Expectation<'tcx>,
1308 expr: &'tcx hir::Expr<'tcx>,
1310 let element_ty = if !args.is_empty() {
1311 let coerce_to = expected
1313 .and_then(|uty| match *uty.kind() {
1314 ty::Array(ty, _) | ty::Slice(ty) => Some(ty),
1317 .unwrap_or_else(|| {
1318 self.next_ty_var(TypeVariableOrigin {
1319 kind: TypeVariableOriginKind::TypeInference,
1323 let mut coerce = CoerceMany::with_coercion_sites(coerce_to, args);
1324 assert_eq!(self.diverges.get(), Diverges::Maybe);
1326 let e_ty = self.check_expr_with_hint(e, coerce_to);
1327 let cause = self.misc(e.span);
1328 coerce.coerce(self, &cause, e, e_ty);
1330 coerce.complete(self)
1332 self.next_ty_var(TypeVariableOrigin {
1333 kind: TypeVariableOriginKind::TypeInference,
1337 let array_len = args.len() as u64;
1338 self.suggest_array_len(expr, array_len);
1339 self.tcx.mk_array(element_ty, array_len)
1342 fn suggest_array_len(&self, expr: &'tcx hir::Expr<'tcx>, array_len: u64) {
1343 let parent_node = self.tcx.hir().parent_iter(expr.hir_id).find(|(_, node)| {
1344 !matches!(node, hir::Node::Expr(hir::Expr { kind: hir::ExprKind::AddrOf(..), .. }))
1347 hir::Node::Local(hir::Local { ty: Some(ty), .. })
1348 | hir::Node::Item(hir::Item { kind: hir::ItemKind::Const(ty, _), .. }))
1349 ) = parent_node else {
1352 if let hir::TyKind::Array(_, length) = ty.peel_refs().kind
1353 && let hir::ArrayLen::Body(hir::AnonConst { hir_id, .. }) = length
1354 && let Some(span) = self.tcx.hir().opt_span(hir_id)
1356 match self.tcx.sess.diagnostic().steal_diagnostic(span, StashKey::UnderscoreForArrayLengths) {
1358 err.span_suggestion(
1360 "consider specifying the array length",
1362 Applicability::MaybeIncorrect,
1371 fn check_expr_const_block(
1373 anon_const: &'tcx hir::AnonConst,
1374 expected: Expectation<'tcx>,
1375 _expr: &'tcx hir::Expr<'tcx>,
1377 let body = self.tcx.hir().body(anon_const.body);
1379 // Create a new function context.
1380 let def_id = anon_const.def_id;
1381 let fcx = FnCtxt::new(self, self.param_env.with_const(), def_id);
1382 crate::GatherLocalsVisitor::new(&fcx).visit_body(body);
1384 let ty = fcx.check_expr_with_expectation(&body.value, expected);
1385 fcx.require_type_is_sized(ty, body.value.span, traits::ConstSized);
1386 fcx.write_ty(anon_const.hir_id, ty);
1390 fn check_expr_repeat(
1392 element: &'tcx hir::Expr<'tcx>,
1393 count: &'tcx hir::ArrayLen,
1394 expected: Expectation<'tcx>,
1395 expr: &'tcx hir::Expr<'tcx>,
1398 let count = self.array_length_to_const(count);
1399 if let Some(count) = count.try_eval_usize(tcx, self.param_env) {
1400 self.suggest_array_len(expr, count);
1403 let uty = match expected {
1404 ExpectHasType(uty) => match *uty.kind() {
1405 ty::Array(ty, _) | ty::Slice(ty) => Some(ty),
1411 let (element_ty, t) = match uty {
1413 self.check_expr_coercable_to_type(&element, uty, None);
1417 let ty = self.next_ty_var(TypeVariableOrigin {
1418 kind: TypeVariableOriginKind::MiscVariable,
1421 let element_ty = self.check_expr_has_type_or_error(&element, ty, |_| {});
1426 if element_ty.references_error() {
1427 return tcx.ty_error();
1430 self.check_repeat_element_needs_copy_bound(element, count, element_ty);
1432 tcx.mk_ty(ty::Array(t, count))
1435 fn check_repeat_element_needs_copy_bound(
1437 element: &hir::Expr<'_>,
1438 count: ty::Const<'tcx>,
1439 element_ty: Ty<'tcx>,
1442 // Actual constants as the repeat element get inserted repeatedly instead of getting copied via Copy.
1443 match &element.kind {
1444 hir::ExprKind::ConstBlock(..) => return,
1445 hir::ExprKind::Path(qpath) => {
1446 let res = self.typeck_results.borrow().qpath_res(qpath, element.hir_id);
1447 if let Res::Def(DefKind::Const | DefKind::AssocConst | DefKind::AnonConst, _) = res
1454 // If someone calls a const fn, they can extract that call out into a separate constant (or a const
1455 // block in the future), so we check that to tell them that in the diagnostic. Does not affect typeck.
1456 let is_const_fn = match element.kind {
1457 hir::ExprKind::Call(func, _args) => match *self.node_ty(func.hir_id).kind() {
1458 ty::FnDef(def_id, _) => tcx.is_const_fn(def_id),
1464 // If the length is 0, we don't create any elements, so we don't copy any. If the length is 1, we
1465 // don't copy that one element, we move it. Only check for Copy if the length is larger.
1466 if count.try_eval_usize(tcx, self.param_env).map_or(true, |len| len > 1) {
1467 let lang_item = self.tcx.require_lang_item(LangItem::Copy, None);
1468 let code = traits::ObligationCauseCode::RepeatElementCopy { is_const_fn };
1469 self.require_type_meets(element_ty, element.span, code, lang_item);
1473 fn check_expr_tuple(
1475 elts: &'tcx [hir::Expr<'tcx>],
1476 expected: Expectation<'tcx>,
1477 expr: &'tcx hir::Expr<'tcx>,
1479 let flds = expected.only_has_type(self).and_then(|ty| {
1480 let ty = self.resolve_vars_with_obligations(ty);
1482 ty::Tuple(flds) => Some(&flds[..]),
1487 let elt_ts_iter = elts.iter().enumerate().map(|(i, e)| match flds {
1488 Some(fs) if i < fs.len() => {
1490 self.check_expr_coercable_to_type(&e, ety, None);
1493 _ => self.check_expr_with_expectation(&e, NoExpectation),
1495 let tuple = self.tcx.mk_tup(elt_ts_iter);
1496 if tuple.references_error() {
1499 self.require_type_is_sized(tuple, expr.span, traits::TupleInitializerSized);
1504 fn check_expr_struct(
1506 expr: &hir::Expr<'_>,
1507 expected: Expectation<'tcx>,
1509 fields: &'tcx [hir::ExprField<'tcx>],
1510 base_expr: &'tcx Option<&'tcx hir::Expr<'tcx>>,
1512 // Find the relevant variant
1513 let Some((variant, adt_ty)) = self.check_struct_path(qpath, expr.hir_id) else {
1514 self.check_struct_fields_on_error(fields, base_expr);
1515 return self.tcx.ty_error();
1518 // Prohibit struct expressions when non-exhaustive flag is set.
1519 let adt = adt_ty.ty_adt_def().expect("`check_struct_path` returned non-ADT type");
1520 if !adt.did().is_local() && variant.is_field_list_non_exhaustive() {
1523 .emit_err(StructExprNonExhaustive { span: expr.span, what: adt.variant_descr() });
1526 self.check_expr_struct_fields(
1537 self.require_type_is_sized(adt_ty, expr.span, traits::StructInitializerSized);
1541 fn check_expr_struct_fields(
1544 expected: Expectation<'tcx>,
1545 expr_id: hir::HirId,
1547 variant: &'tcx ty::VariantDef,
1548 ast_fields: &'tcx [hir::ExprField<'tcx>],
1549 base_expr: &'tcx Option<&'tcx hir::Expr<'tcx>>,
1554 let expected_inputs =
1555 self.expected_inputs_for_expected_output(span, expected, adt_ty, &[adt_ty]);
1556 let adt_ty_hint = if let Some(expected_inputs) = expected_inputs {
1557 expected_inputs.get(0).cloned().unwrap_or(adt_ty)
1561 // re-link the regions that EIfEO can erase.
1562 self.demand_eqtype(span, adt_ty_hint, adt_ty);
1564 let ty::Adt(adt, substs) = adt_ty.kind() else {
1565 span_bug!(span, "non-ADT passed to check_expr_struct_fields");
1567 let adt_kind = adt.adt_kind();
1569 let mut remaining_fields = variant
1573 .map(|(i, field)| (field.ident(tcx).normalize_to_macros_2_0(), (i, field)))
1574 .collect::<FxHashMap<_, _>>();
1576 let mut seen_fields = FxHashMap::default();
1578 let mut error_happened = false;
1580 // Type-check each field.
1581 for (idx, field) in ast_fields.iter().enumerate() {
1582 let ident = tcx.adjust_ident(field.ident, variant.def_id);
1583 let field_type = if let Some((i, v_field)) = remaining_fields.remove(&ident) {
1584 seen_fields.insert(ident, field.span);
1585 self.write_field_index(field.hir_id, i);
1587 // We don't look at stability attributes on
1588 // struct-like enums (yet...), but it's definitely not
1589 // a bug to have constructed one.
1590 if adt_kind != AdtKind::Enum {
1591 tcx.check_stability(v_field.did, Some(expr_id), field.span, None);
1594 self.field_ty(field.span, v_field, substs)
1596 error_happened = true;
1597 if let Some(prev_span) = seen_fields.get(&ident) {
1598 tcx.sess.emit_err(FieldMultiplySpecifiedInInitializer {
1599 span: field.ident.span,
1600 prev_span: *prev_span,
1604 self.report_unknown_field(
1609 adt.variant_descr(),
1617 // Make sure to give a type to the field even if there's
1618 // an error, so we can continue type-checking.
1619 let ty = self.check_expr_with_hint(&field.expr, field_type);
1621 self.demand_coerce_diag(&field.expr, ty, field_type, None, AllowTwoPhase::No);
1623 if let Some(mut diag) = diag {
1624 if idx == ast_fields.len() - 1 {
1625 if remaining_fields.is_empty() {
1626 self.suggest_fru_from_range(field, variant, substs, &mut diag);
1629 diag.stash(field.span, StashKey::MaybeFruTypo);
1637 // Make sure the programmer specified correct number of fields.
1638 if adt_kind == AdtKind::Union {
1639 if ast_fields.len() != 1 {
1644 "union expressions should have exactly one field",
1650 // If check_expr_struct_fields hit an error, do not attempt to populate
1651 // the fields with the base_expr. This could cause us to hit errors later
1652 // when certain fields are assumed to exist that in fact do not.
1654 if let Some(base_expr) = base_expr {
1655 self.check_expr(base_expr);
1660 if let Some(base_expr) = base_expr {
1661 // FIXME: We are currently creating two branches here in order to maintain
1662 // consistency. But they should be merged as much as possible.
1663 let fru_tys = if self.tcx.features().type_changing_struct_update {
1664 if adt.is_struct() {
1665 // Make some fresh substitutions for our ADT type.
1666 let fresh_substs = self.fresh_substs_for_item(base_expr.span, adt.did());
1667 // We do subtyping on the FRU fields first, so we can
1668 // learn exactly what types we expect the base expr
1669 // needs constrained to be compatible with the struct
1670 // type we expect from the expectation value.
1671 let fru_tys = variant
1675 let fru_ty = self.normalize(
1677 self.field_ty(base_expr.span, f, fresh_substs),
1679 let ident = self.tcx.adjust_ident(f.ident(self.tcx), variant.def_id);
1680 if let Some(_) = remaining_fields.remove(&ident) {
1681 let target_ty = self.field_ty(base_expr.span, f, substs);
1682 let cause = self.misc(base_expr.span);
1683 match self.at(&cause, self.param_env).sup(target_ty, fru_ty) {
1684 Ok(InferOk { obligations, value: () }) => {
1685 self.register_predicates(obligations)
1688 // This should never happen, since we're just subtyping the
1689 // remaining_fields, but it's fine to emit this, I guess.
1691 .report_mismatched_types(
1695 FieldMisMatch(variant.name, ident.name),
1701 self.resolve_vars_if_possible(fru_ty)
1704 // The use of fresh substs that we have subtyped against
1705 // our base ADT type's fields allows us to guide inference
1706 // along so that, e.g.
1708 // MyStruct<'a, F1, F2, const C: usize> {
1710 // // Other fields that reference `'a`, `F2`, and `C`
1713 // let x = MyStruct {
1718 // will have the `other_struct` expression constrained to
1719 // `MyStruct<'a, _, F2, C>`, as opposed to just `_`...
1720 // This is important to allow coercions to happen in
1721 // `other_struct` itself. See `coerce-in-base-expr.rs`.
1722 let fresh_base_ty = self.tcx.mk_adt(*adt, fresh_substs);
1723 self.check_expr_has_type_or_error(
1725 self.resolve_vars_if_possible(fresh_base_ty),
1730 // Check the base_expr, regardless of a bad expected adt_ty, so we can get
1731 // type errors on that expression, too.
1732 self.check_expr(base_expr);
1735 .emit_err(FunctionalRecordUpdateOnNonStruct { span: base_expr.span });
1739 self.check_expr_has_type_or_error(base_expr, adt_ty, |_| {
1740 let base_ty = self.typeck_results.borrow().expr_ty(*base_expr);
1741 let same_adt = match (adt_ty.kind(), base_ty.kind()) {
1742 (ty::Adt(adt, _), ty::Adt(base_adt, _)) if adt == base_adt => true,
1745 if self.tcx.sess.is_nightly_build() && same_adt {
1747 &self.tcx.sess.parse_sess,
1748 sym::type_changing_struct_update,
1750 "type changing struct updating is experimental",
1755 match adt_ty.kind() {
1756 ty::Adt(adt, substs) if adt.is_struct() => variant
1759 .map(|f| self.normalize(expr_span, f.ty(self.tcx, substs)))
1764 .emit_err(FunctionalRecordUpdateOnNonStruct { span: base_expr.span });
1769 self.typeck_results.borrow_mut().fru_field_types_mut().insert(expr_id, fru_tys);
1770 } else if adt_kind != AdtKind::Union && !remaining_fields.is_empty() {
1771 debug!(?remaining_fields);
1772 let private_fields: Vec<&ty::FieldDef> = variant
1775 .filter(|field| !field.vis.is_accessible_from(tcx.parent_module(expr_id), tcx))
1778 if !private_fields.is_empty() {
1779 self.report_private_fields(adt_ty, span, private_fields, ast_fields);
1781 self.report_missing_fields(
1793 fn check_struct_fields_on_error(
1795 fields: &'tcx [hir::ExprField<'tcx>],
1796 base_expr: &'tcx Option<&'tcx hir::Expr<'tcx>>,
1798 for field in fields {
1799 self.check_expr(&field.expr);
1801 if let Some(base) = *base_expr {
1802 self.check_expr(&base);
1806 /// Report an error for a struct field expression when there are fields which aren't provided.
1809 /// error: missing field `you_can_use_this_field` in initializer of `foo::Foo`
1810 /// --> src/main.rs:8:5
1812 /// 8 | foo::Foo {};
1813 /// | ^^^^^^^^ missing `you_can_use_this_field`
1815 /// error: aborting due to previous error
1817 fn report_missing_fields(
1821 remaining_fields: FxHashMap<Ident, (usize, &ty::FieldDef)>,
1822 variant: &'tcx ty::VariantDef,
1823 ast_fields: &'tcx [hir::ExprField<'tcx>],
1824 substs: SubstsRef<'tcx>,
1826 let len = remaining_fields.len();
1828 let mut displayable_field_names: Vec<&str> =
1829 remaining_fields.keys().map(|ident| ident.as_str()).collect();
1830 // sorting &str primitives here, sort_unstable is ok
1831 displayable_field_names.sort_unstable();
1833 let mut truncated_fields_error = String::new();
1834 let remaining_fields_names = match &displayable_field_names[..] {
1835 [field1] => format!("`{}`", field1),
1836 [field1, field2] => format!("`{field1}` and `{field2}`"),
1837 [field1, field2, field3] => format!("`{field1}`, `{field2}` and `{field3}`"),
1839 truncated_fields_error =
1840 format!(" and {} other field{}", len - 3, pluralize!(len - 3));
1841 displayable_field_names
1844 .map(|n| format!("`{n}`"))
1845 .collect::<Vec<_>>()
1850 let mut err = struct_span_err!(
1854 "missing field{} {}{} in initializer of `{}`",
1856 remaining_fields_names,
1857 truncated_fields_error,
1860 err.span_label(span, format!("missing {remaining_fields_names}{truncated_fields_error}"));
1862 if let Some(last) = ast_fields.last() {
1863 self.suggest_fru_from_range(last, variant, substs, &mut err);
1869 /// If the last field is a range literal, but it isn't supposed to be, then they probably
1870 /// meant to use functional update syntax.
1871 fn suggest_fru_from_range(
1873 last_expr_field: &hir::ExprField<'tcx>,
1874 variant: &ty::VariantDef,
1875 substs: SubstsRef<'tcx>,
1876 err: &mut Diagnostic,
1878 // I don't use 'is_range_literal' because only double-sided, half-open ranges count.
1879 if let ExprKind::Struct(
1880 QPath::LangItem(LangItem::Range, ..),
1881 [range_start, range_end],
1883 ) = last_expr_field.expr.kind
1884 && let variant_field =
1885 variant.fields.iter().find(|field| field.ident(self.tcx) == last_expr_field.ident)
1886 && let range_def_id = self.tcx.lang_items().range_struct()
1888 .and_then(|field| field.ty(self.tcx, substs).ty_adt_def())
1889 .map(|adt| adt.did())
1892 // Suppress any range expr type mismatches
1893 if let Some(mut diag) = self
1897 .steal_diagnostic(last_expr_field.span, StashKey::MaybeFruTypo)
1899 diag.delay_as_bug();
1902 // Use a (somewhat arbitrary) filtering heuristic to avoid printing
1903 // expressions that are either too long, or have control character
1904 //such as newlines in them.
1909 .span_to_snippet(range_end.expr.span)
1911 .filter(|s| s.len() < 25 && !s.contains(|c: char| c.is_control()));
1917 .span_extend_while(range_start.span, |c| c.is_whitespace())
1918 .unwrap_or(range_start.span).shrink_to_hi().to(range_end.span);
1920 err.subdiagnostic(TypeMismatchFruTypo {
1921 expr_span: range_start.span,
1928 /// Report an error for a struct field expression when there are invisible fields.
1931 /// error: cannot construct `Foo` with struct literal syntax due to private fields
1932 /// --> src/main.rs:8:5
1934 /// 8 | foo::Foo {};
1937 /// error: aborting due to previous error
1939 fn report_private_fields(
1943 private_fields: Vec<&ty::FieldDef>,
1944 used_fields: &'tcx [hir::ExprField<'tcx>],
1946 let mut err = self.tcx.sess.struct_span_err(
1949 "cannot construct `{adt_ty}` with struct literal syntax due to private fields",
1952 let (used_private_fields, remaining_private_fields): (
1953 Vec<(Symbol, Span, bool)>,
1954 Vec<(Symbol, Span, bool)>,
1958 match used_fields.iter().find(|used_field| field.name == used_field.ident.name) {
1959 Some(used_field) => (field.name, used_field.span, true),
1960 None => (field.name, self.tcx.def_span(field.did), false),
1963 .partition(|field| field.2);
1964 err.span_labels(used_private_fields.iter().map(|(_, span, _)| *span), "private field");
1965 if !remaining_private_fields.is_empty() {
1966 let remaining_private_fields_len = remaining_private_fields.len();
1967 let names = match &remaining_private_fields
1969 .map(|(name, _, _)| name)
1970 .collect::<Vec<_>>()[..]
1972 _ if remaining_private_fields_len > 6 => String::new(),
1973 [name] => format!("`{name}` "),
1974 [names @ .., last] => {
1975 let names = names.iter().map(|name| format!("`{name}`")).collect::<Vec<_>>();
1976 format!("{} and `{last}` ", names.join(", "))
1978 [] => unreachable!(),
1981 "... and other private field{s} {names}that {were} not provided",
1982 s = pluralize!(remaining_private_fields_len),
1983 were = pluralize!("was", remaining_private_fields_len),
1989 fn report_unknown_field(
1992 variant: &'tcx ty::VariantDef,
1993 field: &hir::ExprField<'_>,
1994 skip_fields: &[hir::ExprField<'_>],
1998 if variant.is_recovered() {
1999 self.set_tainted_by_errors(
2002 .delay_span_bug(expr_span, "parser recovered but no error was emitted"),
2006 let mut err = self.err_ctxt().type_error_struct_with_diag(
2008 |actual| match ty.kind() {
2009 ty::Adt(adt, ..) if adt.is_enum() => struct_span_err!(
2013 "{} `{}::{}` has no field named `{}`",
2019 _ => struct_span_err!(
2023 "{} `{}` has no field named `{}`",
2032 let variant_ident_span = self.tcx.def_ident_span(variant.def_id).unwrap();
2033 match variant.ctor_kind() {
2034 Some(CtorKind::Fn) => match ty.kind() {
2035 ty::Adt(adt, ..) if adt.is_enum() => {
2039 "`{adt}::{variant}` defined here",
2041 variant = variant.name,
2044 err.span_label(field.ident.span, "field does not exist");
2045 err.span_suggestion_verbose(
2048 "`{adt}::{variant}` is a tuple {kind_name}, use the appropriate syntax",
2050 variant = variant.name,
2053 "{adt}::{variant}(/* fields */)",
2055 variant = variant.name,
2057 Applicability::HasPlaceholders,
2061 err.span_label(variant_ident_span, format!("`{adt}` defined here", adt = ty));
2062 err.span_label(field.ident.span, "field does not exist");
2063 err.span_suggestion_verbose(
2066 "`{adt}` is a tuple {kind_name}, use the appropriate syntax",
2068 kind_name = kind_name,
2070 format!("{adt}(/* fields */)", adt = ty),
2071 Applicability::HasPlaceholders,
2076 // prevent all specified fields from being suggested
2077 let skip_fields = skip_fields.iter().map(|x| x.ident.name);
2078 if let Some(field_name) = self.suggest_field_name(
2081 skip_fields.collect(),
2084 err.span_suggestion(
2086 "a field with a similar name exists",
2088 Applicability::MaybeIncorrect,
2092 ty::Adt(adt, ..) => {
2096 format!("`{}::{}` does not have this field", ty, variant.name),
2101 format!("`{ty}` does not have this field"),
2104 let available_field_names =
2105 self.available_field_names(variant, expr_span);
2106 if !available_field_names.is_empty() {
2108 "available fields are: {}",
2109 self.name_series_display(available_field_names)
2113 _ => bug!("non-ADT passed to report_unknown_field"),
2121 // Return a hint about the closest match in field names
2122 fn suggest_field_name(
2124 variant: &'tcx ty::VariantDef,
2127 // The span where stability will be checked
2129 ) -> Option<Symbol> {
2133 .filter_map(|field| {
2134 // ignore already set fields and private fields from non-local crates
2135 // and unstable fields.
2136 if skip.iter().any(|&x| x == field.name)
2137 || (!variant.def_id.is_local() && !field.vis.is_public())
2139 self.tcx.eval_stability(field.did, None, span, None),
2140 stability::EvalResult::Deny { .. }
2148 .collect::<Vec<Symbol>>();
2150 find_best_match_for_name(&names, field, None)
2153 fn available_field_names(
2155 variant: &'tcx ty::VariantDef,
2158 let body_owner_hir_id = self.tcx.hir().local_def_id_to_hir_id(self.body_id);
2163 let def_scope = self
2165 .adjust_ident_and_get_scope(
2166 field.ident(self.tcx),
2171 field.vis.is_accessible_from(def_scope, self.tcx)
2173 self.tcx.eval_stability(field.did, None, access_span, None),
2174 stability::EvalResult::Deny { .. }
2177 .filter(|field| !self.tcx.is_doc_hidden(field.did))
2178 .map(|field| field.name)
2182 fn name_series_display(&self, names: Vec<Symbol>) -> String {
2183 // dynamic limit, to never omit just one field
2184 let limit = if names.len() == 6 { 6 } else { 5 };
2186 names.iter().take(limit).map(|n| format!("`{}`", n)).collect::<Vec<_>>().join(", ");
2187 if names.len() > limit {
2188 display = format!("{} ... and {} others", display, names.len() - limit);
2193 // Check field access expressions
2196 expr: &'tcx hir::Expr<'tcx>,
2197 base: &'tcx hir::Expr<'tcx>,
2199 expected: Expectation<'tcx>,
2201 debug!("check_field(expr: {:?}, base: {:?}, field: {:?})", expr, base, field);
2202 let base_ty = self.check_expr(base);
2203 let base_ty = self.structurally_resolved_type(base.span, base_ty);
2204 let mut private_candidate = None;
2205 let mut autoderef = self.autoderef(expr.span, base_ty);
2206 while let Some((deref_base_ty, _)) = autoderef.next() {
2207 debug!("deref_base_ty: {:?}", deref_base_ty);
2208 match deref_base_ty.kind() {
2209 ty::Adt(base_def, substs) if !base_def.is_enum() => {
2210 debug!("struct named {:?}", deref_base_ty);
2211 let body_hir_id = self.tcx.hir().local_def_id_to_hir_id(self.body_id);
2212 let (ident, def_scope) =
2213 self.tcx.adjust_ident_and_get_scope(field, base_def.did(), body_hir_id);
2214 let fields = &base_def.non_enum_variant().fields;
2215 if let Some(index) = fields
2217 .position(|f| f.ident(self.tcx).normalize_to_macros_2_0() == ident)
2219 let field = &fields[index];
2220 let field_ty = self.field_ty(expr.span, field, substs);
2221 // Save the index of all fields regardless of their visibility in case
2222 // of error recovery.
2223 self.write_field_index(expr.hir_id, index);
2224 let adjustments = self.adjust_steps(&autoderef);
2225 if field.vis.is_accessible_from(def_scope, self.tcx) {
2226 self.apply_adjustments(base, adjustments);
2227 self.register_predicates(autoderef.into_obligations());
2229 self.tcx.check_stability(field.did, Some(expr.hir_id), expr.span, None);
2232 private_candidate = Some((adjustments, base_def.did()));
2236 let fstr = field.as_str();
2237 if let Ok(index) = fstr.parse::<usize>() {
2238 if fstr == index.to_string() {
2239 if let Some(&field_ty) = tys.get(index) {
2240 let adjustments = self.adjust_steps(&autoderef);
2241 self.apply_adjustments(base, adjustments);
2242 self.register_predicates(autoderef.into_obligations());
2244 self.write_field_index(expr.hir_id, index);
2253 self.structurally_resolved_type(autoderef.span(), autoderef.final_ty(false));
2255 if let Some((adjustments, did)) = private_candidate {
2256 // (#90483) apply adjustments to avoid ExprUseVisitor from
2257 // creating erroneous projection.
2258 self.apply_adjustments(base, adjustments);
2259 self.ban_private_field_access(expr, base_ty, field, did, expected.only_has_type(self));
2260 return self.tcx().ty_error();
2263 if field.name == kw::Empty {
2264 } else if self.method_exists(
2269 expected.only_has_type(self),
2271 self.ban_take_value_of_method(expr, base_ty, field);
2272 } else if !base_ty.is_primitive_ty() {
2273 self.ban_nonexisting_field(field, base, expr, base_ty);
2275 let field_name = field.to_string();
2276 let mut err = type_error_struct!(
2281 "`{base_ty}` is a primitive type and therefore doesn't have fields",
2283 let is_valid_suffix = |field: &str| {
2284 if field == "f32" || field == "f64" {
2287 let mut chars = field.chars().peekable();
2288 match chars.peek() {
2289 Some('e') | Some('E') => {
2291 if let Some(c) = chars.peek()
2292 && !c.is_numeric() && *c != '-' && *c != '+'
2296 while let Some(c) = chars.peek() {
2297 if !c.is_numeric() {
2305 let suffix = chars.collect::<String>();
2306 suffix.is_empty() || suffix == "f32" || suffix == "f64"
2308 let maybe_partial_suffix = |field: &str| -> Option<&str> {
2309 let first_chars = ['f', 'l'];
2311 && field.to_lowercase().starts_with(first_chars)
2312 && field[1..].chars().all(|c| c.is_ascii_digit())
2314 if field.to_lowercase().starts_with(['f']) { Some("f32") } else { Some("f64") }
2319 if let ty::Infer(ty::IntVar(_)) = base_ty.kind()
2320 && let ExprKind::Lit(Spanned {
2321 node: ast::LitKind::Int(_, ast::LitIntType::Unsuffixed),
2324 && !base.span.from_expansion()
2326 if is_valid_suffix(&field_name) {
2327 err.span_suggestion_verbose(
2328 field.span.shrink_to_lo(),
2329 "if intended to be a floating point literal, consider adding a `0` after the period",
2331 Applicability::MaybeIncorrect,
2333 } else if let Some(correct_suffix) = maybe_partial_suffix(&field_name) {
2334 err.span_suggestion_verbose(
2336 format!("if intended to be a floating point literal, consider adding a `0` after the period and a `{correct_suffix}` suffix"),
2337 format!("0{correct_suffix}"),
2338 Applicability::MaybeIncorrect,
2345 self.tcx().ty_error()
2348 fn suggest_await_on_field_access(
2350 err: &mut Diagnostic,
2352 base: &'tcx hir::Expr<'tcx>,
2355 let Some(output_ty) = self.get_impl_future_output_ty(ty) else { return; };
2356 let mut add_label = true;
2357 if let ty::Adt(def, _) = output_ty.kind() {
2358 // no field access on enum type
2364 .any(|field| field.ident(self.tcx) == field_ident)
2369 "field not available in `impl Future`, but it is available in its `Output`",
2371 err.span_suggestion_verbose(
2372 base.span.shrink_to_hi(),
2373 "consider `await`ing on the `Future` and access the field of its `Output`",
2375 Applicability::MaybeIncorrect,
2381 err.span_label(field_ident.span, &format!("field not found in `{ty}`"));
2385 fn ban_nonexisting_field(
2388 base: &'tcx hir::Expr<'tcx>,
2389 expr: &'tcx hir::Expr<'tcx>,
2393 "ban_nonexisting_field: field={:?}, base={:?}, expr={:?}, base_ty={:?}",
2394 ident, base, expr, base_ty
2396 let mut err = self.no_such_field_err(ident, base_ty, base.hir_id);
2398 match *base_ty.peel_refs().kind() {
2399 ty::Array(_, len) => {
2400 self.maybe_suggest_array_indexing(&mut err, expr, base, ident, len);
2403 self.suggest_first_deref_field(&mut err, expr, base, ident);
2405 ty::Adt(def, _) if !def.is_enum() => {
2406 self.suggest_fields_on_recordish(&mut err, def, ident, expr.span);
2408 ty::Param(param_ty) => {
2409 self.point_at_param_definition(&mut err, param_ty);
2411 ty::Alias(ty::Opaque, _) => {
2412 self.suggest_await_on_field_access(&mut err, ident, base, base_ty.peel_refs());
2417 self.suggest_fn_call(&mut err, base, base_ty, |output_ty| {
2418 if let ty::Adt(def, _) = output_ty.kind() && !def.is_enum() {
2419 def.non_enum_variant().fields.iter().any(|field| {
2420 field.ident(self.tcx) == ident
2421 && field.vis.is_accessible_from(expr.hir_id.owner.def_id, self.tcx)
2423 } else if let ty::Tuple(tys) = output_ty.kind()
2424 && let Ok(idx) = ident.as_str().parse::<usize>()
2432 if ident.name == kw::Await {
2433 // We know by construction that `<expr>.await` is either on Rust 2015
2434 // or results in `ExprKind::Await`. Suggest switching the edition to 2018.
2435 err.note("to `.await` a `Future`, switch to Rust 2018 or later");
2436 HelpUseLatestEdition::new().add_to_diagnostic(&mut err);
2442 fn ban_private_field_access(
2444 expr: &hir::Expr<'tcx>,
2448 return_ty: Option<Ty<'tcx>>,
2450 let struct_path = self.tcx().def_path_str(base_did);
2451 let kind_name = self.tcx().def_kind(base_did).descr(base_did);
2452 let mut err = struct_span_err!(
2456 "field `{field}` of {kind_name} `{struct_path}` is private",
2458 err.span_label(field.span, "private field");
2459 // Also check if an accessible method exists, which is often what is meant.
2460 if self.method_exists(field, expr_t, expr.hir_id, false, return_ty)
2461 && !self.expr_in_place(expr.hir_id)
2463 self.suggest_method_call(
2465 &format!("a method `{field}` also exists, call it with parentheses"),
2475 fn ban_take_value_of_method(&self, expr: &hir::Expr<'tcx>, expr_t: Ty<'tcx>, field: Ident) {
2476 let mut err = type_error_struct!(
2481 "attempted to take value of method `{field}` on type `{expr_t}`",
2483 err.span_label(field.span, "method, not a field");
2485 if let hir::Node::Expr(hir::Expr { kind: ExprKind::Call(callee, _args), .. }) =
2486 self.tcx.hir().get_parent(expr.hir_id)
2488 expr.hir_id == callee.hir_id
2493 self.tcx.sess.source_map().span_to_snippet(expr.span).unwrap_or_default();
2494 let is_wrapped = expr_snippet.starts_with('(') && expr_snippet.ends_with(')');
2495 let after_open = expr.span.lo() + rustc_span::BytePos(1);
2496 let before_close = expr.span.hi() - rustc_span::BytePos(1);
2498 if expr_is_call && is_wrapped {
2499 err.multipart_suggestion(
2500 "remove wrapping parentheses to call the method",
2502 (expr.span.with_hi(after_open), String::new()),
2503 (expr.span.with_lo(before_close), String::new()),
2505 Applicability::MachineApplicable,
2507 } else if !self.expr_in_place(expr.hir_id) {
2508 // Suggest call parentheses inside the wrapping parentheses
2509 let span = if is_wrapped {
2510 expr.span.with_lo(after_open).with_hi(before_close)
2514 self.suggest_method_call(
2516 "use parentheses to call the method",
2522 } else if let ty::RawPtr(ty_and_mut) = expr_t.kind()
2523 && let ty::Adt(adt_def, _) = ty_and_mut.ty.kind()
2524 && let ExprKind::Field(base_expr, _) = expr.kind
2525 && adt_def.variants().len() == 1
2533 .any(|f| f.ident(self.tcx) == field)
2535 err.multipart_suggestion(
2536 "to access the field, dereference first",
2538 (base_expr.span.shrink_to_lo(), "(*".to_string()),
2539 (base_expr.span.shrink_to_hi(), ")".to_string()),
2541 Applicability::MaybeIncorrect,
2544 err.help("methods are immutable and cannot be assigned to");
2550 fn point_at_param_definition(&self, err: &mut Diagnostic, param: ty::ParamTy) {
2551 let generics = self.tcx.generics_of(self.body_id);
2552 let generic_param = generics.type_param(¶m, self.tcx);
2553 if let ty::GenericParamDefKind::Type { synthetic: true, .. } = generic_param.kind {
2556 let param_def_id = generic_param.def_id;
2557 let param_hir_id = match param_def_id.as_local() {
2558 Some(x) => self.tcx.hir().local_def_id_to_hir_id(x),
2561 let param_span = self.tcx.hir().span(param_hir_id);
2562 let param_name = self.tcx.hir().ty_param_name(param_def_id.expect_local());
2564 err.span_label(param_span, &format!("type parameter '{param_name}' declared here"));
2567 fn suggest_fields_on_recordish(
2569 err: &mut Diagnostic,
2570 def: ty::AdtDef<'tcx>,
2574 if let Some(suggested_field_name) =
2575 self.suggest_field_name(def.non_enum_variant(), field.name, vec![], access_span)
2577 err.span_suggestion(
2579 "a field with a similar name exists",
2580 suggested_field_name,
2581 Applicability::MaybeIncorrect,
2584 err.span_label(field.span, "unknown field");
2585 let struct_variant_def = def.non_enum_variant();
2586 let field_names = self.available_field_names(struct_variant_def, access_span);
2587 if !field_names.is_empty() {
2589 "available fields are: {}",
2590 self.name_series_display(field_names),
2596 fn maybe_suggest_array_indexing(
2598 err: &mut Diagnostic,
2599 expr: &hir::Expr<'_>,
2600 base: &hir::Expr<'_>,
2602 len: ty::Const<'tcx>,
2604 if let (Some(len), Ok(user_index)) =
2605 (len.try_eval_usize(self.tcx, self.param_env), field.as_str().parse::<u64>())
2606 && let Ok(base) = self.tcx.sess.source_map().span_to_snippet(base.span)
2608 let help = "instead of using tuple indexing, use array indexing";
2609 let suggestion = format!("{base}[{field}]");
2610 let applicability = if len < user_index {
2611 Applicability::MachineApplicable
2613 Applicability::MaybeIncorrect
2615 err.span_suggestion(expr.span, help, suggestion, applicability);
2619 fn suggest_first_deref_field(
2621 err: &mut Diagnostic,
2622 expr: &hir::Expr<'_>,
2623 base: &hir::Expr<'_>,
2626 if let Ok(base) = self.tcx.sess.source_map().span_to_snippet(base.span) {
2627 let msg = format!("`{base}` is a raw pointer; try dereferencing it");
2628 let suggestion = format!("(*{base}).{field}");
2629 err.span_suggestion(expr.span, &msg, suggestion, Applicability::MaybeIncorrect);
2633 fn no_such_field_err(
2638 ) -> DiagnosticBuilder<'_, ErrorGuaranteed> {
2639 let span = field.span;
2640 debug!("no_such_field_err(span: {:?}, field: {:?}, expr_t: {:?})", span, field, expr_t);
2642 let mut err = type_error_struct!(
2647 "no field `{field}` on type `{expr_t}`",
2650 // try to add a suggestion in case the field is a nested field of a field of the Adt
2651 let mod_id = self.tcx.parent_module(id).to_def_id();
2652 if let Some((fields, substs)) =
2653 self.get_field_candidates_considering_privacy(span, expr_t, mod_id)
2655 let candidate_fields: Vec<_> = fields
2656 .filter_map(|candidate_field| {
2657 self.check_for_nested_field_satisfying(
2659 &|candidate_field, _| candidate_field.ident(self.tcx()) == field,
2666 .map(|mut field_path| {
2670 .map(|id| id.name.to_ident_string())
2671 .collect::<Vec<String>>()
2674 .collect::<Vec<_>>();
2676 let len = candidate_fields.len();
2678 err.span_suggestions(
2679 field.span.shrink_to_lo(),
2681 "{} of the expressions' fields {} a field of the same name",
2682 if len > 1 { "some" } else { "one" },
2683 if len > 1 { "have" } else { "has" },
2685 candidate_fields.iter().map(|path| format!("{path}.")),
2686 Applicability::MaybeIncorrect,
2693 pub(crate) fn get_field_candidates_considering_privacy(
2698 ) -> Option<(impl Iterator<Item = &'tcx ty::FieldDef> + 'tcx, SubstsRef<'tcx>)> {
2699 debug!("get_field_candidates(span: {:?}, base_t: {:?}", span, base_ty);
2701 for (base_t, _) in self.autoderef(span, base_ty) {
2702 match base_t.kind() {
2703 ty::Adt(base_def, substs) if !base_def.is_enum() => {
2705 let fields = &base_def.non_enum_variant().fields;
2706 // Some struct, e.g. some that impl `Deref`, have all private fields
2707 // because you're expected to deref them to access the _real_ fields.
2708 // This, for example, will help us suggest accessing a field through a `Box<T>`.
2709 if fields.iter().all(|field| !field.vis.is_accessible_from(mod_id, tcx)) {
2715 .filter(move |field| field.vis.is_accessible_from(mod_id, tcx))
2716 // For compile-time reasons put a limit on number of fields we search
2727 /// This method is called after we have encountered a missing field error to recursively
2728 /// search for the field
2729 pub(crate) fn check_for_nested_field_satisfying(
2732 matches: &impl Fn(&ty::FieldDef, Ty<'tcx>) -> bool,
2733 candidate_field: &ty::FieldDef,
2734 subst: SubstsRef<'tcx>,
2735 mut field_path: Vec<Ident>,
2737 ) -> Option<Vec<Ident>> {
2739 "check_for_nested_field_satisfying(span: {:?}, candidate_field: {:?}, field_path: {:?}",
2740 span, candidate_field, field_path
2743 if field_path.len() > 3 {
2744 // For compile-time reasons and to avoid infinite recursion we only check for fields
2745 // up to a depth of three
2748 field_path.push(candidate_field.ident(self.tcx).normalize_to_macros_2_0());
2749 let field_ty = candidate_field.ty(self.tcx, subst);
2750 if matches(candidate_field, field_ty) {
2751 return Some(field_path);
2752 } else if let Some((nested_fields, subst)) =
2753 self.get_field_candidates_considering_privacy(span, field_ty, mod_id)
2755 // recursively search fields of `candidate_field` if it's a ty::Adt
2756 for field in nested_fields {
2757 if let Some(field_path) = self.check_for_nested_field_satisfying(
2765 return Some(field_path);
2773 fn check_expr_index(
2775 base: &'tcx hir::Expr<'tcx>,
2776 idx: &'tcx hir::Expr<'tcx>,
2777 expr: &'tcx hir::Expr<'tcx>,
2779 let base_t = self.check_expr(&base);
2780 let idx_t = self.check_expr(&idx);
2782 if base_t.references_error() {
2784 } else if idx_t.references_error() {
2787 let base_t = self.structurally_resolved_type(base.span, base_t);
2788 match self.lookup_indexing(expr, base, base_t, idx, idx_t) {
2789 Some((index_ty, element_ty)) => {
2790 // two-phase not needed because index_ty is never mutable
2791 self.demand_coerce(idx, idx_t, index_ty, None, AllowTwoPhase::No);
2792 self.select_obligations_where_possible(|errors| {
2793 self.point_at_index_if_possible(errors, idx.span)
2798 let mut err = type_error_struct!(
2803 "cannot index into a value of type `{base_t}`",
2805 // Try to give some advice about indexing tuples.
2806 if let ty::Tuple(..) = base_t.kind() {
2807 let mut needs_note = true;
2808 // If the index is an integer, we can show the actual
2809 // fixed expression:
2810 if let ExprKind::Lit(ref lit) = idx.kind {
2811 if let ast::LitKind::Int(i, ast::LitIntType::Unsuffixed) = lit.node {
2812 let snip = self.tcx.sess.source_map().span_to_snippet(base.span);
2813 if let Ok(snip) = snip {
2814 err.span_suggestion(
2816 "to access tuple elements, use",
2817 format!("{snip}.{i}"),
2818 Applicability::MachineApplicable,
2826 "to access tuple elements, use tuple indexing \
2827 syntax (e.g., `tuple.0`)",
2831 let reported = err.emit();
2832 self.tcx.ty_error_with_guaranteed(reported)
2838 fn point_at_index_if_possible(
2840 errors: &mut Vec<traits::FulfillmentError<'tcx>>,
2843 for error in errors {
2844 match error.obligation.predicate.kind().skip_binder() {
2845 ty::PredicateKind::Clause(ty::Clause::Trait(predicate))
2846 if self.tcx.is_diagnostic_item(sym::SliceIndex, predicate.trait_ref.def_id) => {
2850 error.obligation.cause.span = span;
2854 fn check_expr_yield(
2856 value: &'tcx hir::Expr<'tcx>,
2857 expr: &'tcx hir::Expr<'tcx>,
2858 src: &'tcx hir::YieldSource,
2860 match self.resume_yield_tys {
2861 Some((resume_ty, yield_ty)) => {
2862 self.check_expr_coercable_to_type(&value, yield_ty, None);
2866 // Given that this `yield` expression was generated as a result of lowering a `.await`,
2867 // we know that the yield type must be `()`; however, the context won't contain this
2868 // information. Hence, we check the source of the yield expression here and check its
2869 // value's type against `()` (this check should always hold).
2870 None if src.is_await() => {
2871 self.check_expr_coercable_to_type(&value, self.tcx.mk_unit(), None);
2875 self.tcx.sess.emit_err(YieldExprOutsideOfGenerator { span: expr.span });
2876 // Avoid expressions without types during writeback (#78653).
2877 self.check_expr(value);
2883 fn check_expr_asm_operand(&self, expr: &'tcx hir::Expr<'tcx>, is_input: bool) {
2884 let needs = if is_input { Needs::None } else { Needs::MutPlace };
2885 let ty = self.check_expr_with_needs(expr, needs);
2886 self.require_type_is_sized(ty, expr.span, traits::InlineAsmSized);
2888 if !is_input && !expr.is_syntactic_place_expr() {
2889 let mut err = self.tcx.sess.struct_span_err(expr.span, "invalid asm output");
2890 err.span_label(expr.span, "cannot assign to this expression");
2894 // If this is an input value, we require its type to be fully resolved
2895 // at this point. This allows us to provide helpful coercions which help
2896 // pass the type candidate list in a later pass.
2898 // We don't require output types to be resolved at this point, which
2899 // allows them to be inferred based on how they are used later in the
2902 let ty = self.structurally_resolved_type(expr.span, ty);
2905 let fnptr_ty = self.tcx.mk_fn_ptr(ty.fn_sig(self.tcx));
2906 self.demand_coerce(expr, ty, fnptr_ty, None, AllowTwoPhase::No);
2908 ty::Ref(_, base_ty, mutbl) => {
2909 let ptr_ty = self.tcx.mk_ptr(ty::TypeAndMut { ty: base_ty, mutbl });
2910 self.demand_coerce(expr, ty, ptr_ty, None, AllowTwoPhase::No);
2917 fn check_expr_asm(&self, asm: &'tcx hir::InlineAsm<'tcx>) -> Ty<'tcx> {
2918 for (op, _op_sp) in asm.operands {
2920 hir::InlineAsmOperand::In { expr, .. } => {
2921 self.check_expr_asm_operand(expr, true);
2923 hir::InlineAsmOperand::Out { expr: Some(expr), .. }
2924 | hir::InlineAsmOperand::InOut { expr, .. } => {
2925 self.check_expr_asm_operand(expr, false);
2927 hir::InlineAsmOperand::Out { expr: None, .. } => {}
2928 hir::InlineAsmOperand::SplitInOut { in_expr, out_expr, .. } => {
2929 self.check_expr_asm_operand(in_expr, true);
2930 if let Some(out_expr) = out_expr {
2931 self.check_expr_asm_operand(out_expr, false);
2934 // `AnonConst`s have their own body and is type-checked separately.
2935 // As they don't flow into the type system we don't need them to
2937 hir::InlineAsmOperand::Const { .. } | hir::InlineAsmOperand::SymFn { .. } => {}
2938 hir::InlineAsmOperand::SymStatic { .. } => {}
2941 if asm.options.contains(ast::InlineAsmOptions::NORETURN) {
2942 self.tcx.types.never