]> git.lizzy.rs Git - rust.git/blob - src/librustc_typeck/check/mod.rs
Auto merge of #45384 - mikhail-m1:mir_add_false_edges_terminator_kind, r=arielb1
[rust.git] / src / librustc_typeck / check / mod.rs
1 // Copyright 2012-2015 The Rust Project Developers. See the COPYRIGHT
2 // file at the top-level directory of this distribution and at
3 // http://rust-lang.org/COPYRIGHT.
4 //
5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
8 // option. This file may not be copied, modified, or distributed
9 // except according to those terms.
10
11 /*
12
13 # check.rs
14
15 Within the check phase of type check, we check each item one at a time
16 (bodies of function expressions are checked as part of the containing
17 function).  Inference is used to supply types wherever they are
18 unknown.
19
20 By far the most complex case is checking the body of a function. This
21 can be broken down into several distinct phases:
22
23 - gather: creates type variables to represent the type of each local
24   variable and pattern binding.
25
26 - main: the main pass does the lion's share of the work: it
27   determines the types of all expressions, resolves
28   methods, checks for most invalid conditions, and so forth.  In
29   some cases, where a type is unknown, it may create a type or region
30   variable and use that as the type of an expression.
31
32   In the process of checking, various constraints will be placed on
33   these type variables through the subtyping relationships requested
34   through the `demand` module.  The `infer` module is in charge
35   of resolving those constraints.
36
37 - regionck: after main is complete, the regionck pass goes over all
38   types looking for regions and making sure that they did not escape
39   into places they are not in scope.  This may also influence the
40   final assignments of the various region variables if there is some
41   flexibility.
42
43 - vtable: find and records the impls to use for each trait bound that
44   appears on a type parameter.
45
46 - writeback: writes the final types within a function body, replacing
47   type variables with their final inferred types.  These final types
48   are written into the `tcx.node_types` table, which should *never* contain
49   any reference to a type variable.
50
51 ## Intermediate types
52
53 While type checking a function, the intermediate types for the
54 expressions, blocks, and so forth contained within the function are
55 stored in `fcx.node_types` and `fcx.node_substs`.  These types
56 may contain unresolved type variables.  After type checking is
57 complete, the functions in the writeback module are used to take the
58 types from this table, resolve them, and then write them into their
59 permanent home in the type context `tcx`.
60
61 This means that during inferencing you should use `fcx.write_ty()`
62 and `fcx.expr_ty()` / `fcx.node_ty()` to write/obtain the types of
63 nodes within the function.
64
65 The types of top-level items, which never contain unbound type
66 variables, are stored directly into the `tcx` tables.
67
68 n.b.: A type variable is not the same thing as a type parameter.  A
69 type variable is rather an "instance" of a type parameter: that is,
70 given a generic function `fn foo<T>(t: T)`: while checking the
71 function `foo`, the type `ty_param(0)` refers to the type `T`, which
72 is treated in abstract.  When `foo()` is called, however, `T` will be
73 substituted for a fresh type variable `N`.  This variable will
74 eventually be resolved to some concrete type (which might itself be
75 type parameter).
76
77 */
78
79 pub use self::Expectation::*;
80 use self::autoderef::Autoderef;
81 use self::callee::DeferredCallResolution;
82 use self::coercion::{CoerceMany, DynamicCoerceMany};
83 pub use self::compare_method::{compare_impl_method, compare_const_impl};
84 use self::method::MethodCallee;
85 use self::TupleArgumentsFlag::*;
86
87 use astconv::AstConv;
88 use hir::def::{Def, CtorKind};
89 use hir::def_id::{CrateNum, DefId, LOCAL_CRATE};
90 use rustc_back::slice::ref_slice;
91 use namespace::Namespace;
92 use rustc::infer::{self, InferCtxt, InferOk, RegionVariableOrigin};
93 use rustc::infer::type_variable::{TypeVariableOrigin};
94 use rustc::middle::region;
95 use rustc::ty::subst::{Kind, Subst, Substs};
96 use rustc::traits::{self, FulfillmentContext, ObligationCause, ObligationCauseCode};
97 use rustc::ty::{ParamTy, LvaluePreference, NoPreference, PreferMutLvalue};
98 use rustc::ty::{self, Ty, TyCtxt, Visibility};
99 use rustc::ty::adjustment::{Adjust, Adjustment, AutoBorrow};
100 use rustc::ty::fold::{BottomUpFolder, TypeFoldable};
101 use rustc::ty::maps::Providers;
102 use rustc::ty::util::{Representability, IntTypeExt};
103 use errors::{DiagnosticBuilder, DiagnosticId};
104 use require_c_abi_if_variadic;
105 use session::{CompileIncomplete, Session};
106 use TypeAndSubsts;
107 use lint;
108 use util::common::{ErrorReported, indenter};
109 use util::nodemap::{DefIdMap, DefIdSet, FxHashMap, NodeMap};
110
111 use std::cell::{Cell, RefCell, Ref, RefMut};
112 use std::rc::Rc;
113 use std::collections::hash_map::Entry;
114 use std::cmp;
115 use std::fmt::Display;
116 use std::mem::replace;
117 use std::ops::{self, Deref};
118 use syntax::abi::Abi;
119 use syntax::ast;
120 use syntax::codemap::{self, original_sp, Spanned};
121 use syntax::feature_gate::{GateIssue, emit_feature_err};
122 use syntax::ptr::P;
123 use syntax::symbol::{Symbol, InternedString, keywords};
124 use syntax::util::lev_distance::find_best_match_for_name;
125 use syntax_pos::{self, BytePos, Span, MultiSpan};
126
127 use rustc::hir::intravisit::{self, Visitor, NestedVisitorMap};
128 use rustc::hir::itemlikevisit::ItemLikeVisitor;
129 use rustc::hir::map::Node;
130 use rustc::hir::{self, PatKind};
131 use rustc::middle::lang_items;
132 use rustc_back::slice;
133 use rustc_const_math::ConstInt;
134
135 mod autoderef;
136 pub mod dropck;
137 pub mod _match;
138 pub mod writeback;
139 pub mod regionck;
140 pub mod coercion;
141 pub mod demand;
142 pub mod method;
143 mod upvar;
144 mod wfcheck;
145 mod cast;
146 mod closure;
147 mod callee;
148 mod compare_method;
149 mod generator_interior;
150 mod intrinsic;
151 mod op;
152
153 /// A wrapper for InferCtxt's `in_progress_tables` field.
154 #[derive(Copy, Clone)]
155 struct MaybeInProgressTables<'a, 'tcx: 'a> {
156     maybe_tables: Option<&'a RefCell<ty::TypeckTables<'tcx>>>,
157 }
158
159 impl<'a, 'tcx> MaybeInProgressTables<'a, 'tcx> {
160     fn borrow(self) -> Ref<'a, ty::TypeckTables<'tcx>> {
161         match self.maybe_tables {
162             Some(tables) => tables.borrow(),
163             None => {
164                 bug!("MaybeInProgressTables: inh/fcx.tables.borrow() with no tables")
165             }
166         }
167     }
168
169     fn borrow_mut(self) -> RefMut<'a, ty::TypeckTables<'tcx>> {
170         match self.maybe_tables {
171             Some(tables) => tables.borrow_mut(),
172             None => {
173                 bug!("MaybeInProgressTables: inh/fcx.tables.borrow_mut() with no tables")
174             }
175         }
176     }
177 }
178
179
180 /// closures defined within the function.  For example:
181 ///
182 ///     fn foo() {
183 ///         bar(move|| { ... })
184 ///     }
185 ///
186 /// Here, the function `foo()` and the closure passed to
187 /// `bar()` will each have their own `FnCtxt`, but they will
188 /// share the inherited fields.
189 pub struct Inherited<'a, 'gcx: 'a+'tcx, 'tcx: 'a> {
190     infcx: InferCtxt<'a, 'gcx, 'tcx>,
191
192     tables: MaybeInProgressTables<'a, 'tcx>,
193
194     locals: RefCell<NodeMap<Ty<'tcx>>>,
195
196     fulfillment_cx: RefCell<traits::FulfillmentContext<'tcx>>,
197
198     // When we process a call like `c()` where `c` is a closure type,
199     // we may not have decided yet whether `c` is a `Fn`, `FnMut`, or
200     // `FnOnce` closure. In that case, we defer full resolution of the
201     // call until upvar inference can kick in and make the
202     // decision. We keep these deferred resolutions grouped by the
203     // def-id of the closure, so that once we decide, we can easily go
204     // back and process them.
205     deferred_call_resolutions: RefCell<DefIdMap<Vec<DeferredCallResolution<'gcx, 'tcx>>>>,
206
207     deferred_cast_checks: RefCell<Vec<cast::CastCheck<'tcx>>>,
208
209     deferred_generator_interiors: RefCell<Vec<(hir::BodyId, Ty<'tcx>)>>,
210
211     // Anonymized types found in explicit return types and their
212     // associated fresh inference variable. Writeback resolves these
213     // variables to get the concrete type, which can be used to
214     // deanonymize TyAnon, after typeck is done with all functions.
215     anon_types: RefCell<NodeMap<Ty<'tcx>>>,
216
217     /// Each type parameter has an implicit region bound that
218     /// indicates it must outlive at least the function body (the user
219     /// may specify stronger requirements). This field indicates the
220     /// region of the callee. If it is `None`, then the parameter
221     /// environment is for an item or something where the "callee" is
222     /// not clear.
223     implicit_region_bound: Option<ty::Region<'tcx>>,
224
225     body_id: Option<hir::BodyId>,
226 }
227
228 impl<'a, 'gcx, 'tcx> Deref for Inherited<'a, 'gcx, 'tcx> {
229     type Target = InferCtxt<'a, 'gcx, 'tcx>;
230     fn deref(&self) -> &Self::Target {
231         &self.infcx
232     }
233 }
234
235 /// When type-checking an expression, we propagate downward
236 /// whatever type hint we are able in the form of an `Expectation`.
237 #[derive(Copy, Clone, Debug)]
238 pub enum Expectation<'tcx> {
239     /// We know nothing about what type this expression should have.
240     NoExpectation,
241
242     /// This expression is an `if` condition, it must resolve to `bool`.
243     ExpectIfCondition,
244
245     /// This expression should have the type given (or some subtype)
246     ExpectHasType(Ty<'tcx>),
247
248     /// This expression will be cast to the `Ty`
249     ExpectCastableToType(Ty<'tcx>),
250
251     /// This rvalue expression will be wrapped in `&` or `Box` and coerced
252     /// to `&Ty` or `Box<Ty>`, respectively. `Ty` is `[A]` or `Trait`.
253     ExpectRvalueLikeUnsized(Ty<'tcx>),
254 }
255
256 impl<'a, 'gcx, 'tcx> Expectation<'tcx> {
257     // Disregard "castable to" expectations because they
258     // can lead us astray. Consider for example `if cond
259     // {22} else {c} as u8` -- if we propagate the
260     // "castable to u8" constraint to 22, it will pick the
261     // type 22u8, which is overly constrained (c might not
262     // be a u8). In effect, the problem is that the
263     // "castable to" expectation is not the tightest thing
264     // we can say, so we want to drop it in this case.
265     // The tightest thing we can say is "must unify with
266     // else branch". Note that in the case of a "has type"
267     // constraint, this limitation does not hold.
268
269     // If the expected type is just a type variable, then don't use
270     // an expected type. Otherwise, we might write parts of the type
271     // when checking the 'then' block which are incompatible with the
272     // 'else' branch.
273     fn adjust_for_branches(&self, fcx: &FnCtxt<'a, 'gcx, 'tcx>) -> Expectation<'tcx> {
274         match *self {
275             ExpectHasType(ety) => {
276                 let ety = fcx.shallow_resolve(ety);
277                 if !ety.is_ty_var() {
278                     ExpectHasType(ety)
279                 } else {
280                     NoExpectation
281                 }
282             }
283             ExpectRvalueLikeUnsized(ety) => {
284                 ExpectRvalueLikeUnsized(ety)
285             }
286             _ => NoExpectation
287         }
288     }
289
290     /// Provide an expectation for an rvalue expression given an *optional*
291     /// hint, which is not required for type safety (the resulting type might
292     /// be checked higher up, as is the case with `&expr` and `box expr`), but
293     /// is useful in determining the concrete type.
294     ///
295     /// The primary use case is where the expected type is a fat pointer,
296     /// like `&[isize]`. For example, consider the following statement:
297     ///
298     ///    let x: &[isize] = &[1, 2, 3];
299     ///
300     /// In this case, the expected type for the `&[1, 2, 3]` expression is
301     /// `&[isize]`. If however we were to say that `[1, 2, 3]` has the
302     /// expectation `ExpectHasType([isize])`, that would be too strong --
303     /// `[1, 2, 3]` does not have the type `[isize]` but rather `[isize; 3]`.
304     /// It is only the `&[1, 2, 3]` expression as a whole that can be coerced
305     /// to the type `&[isize]`. Therefore, we propagate this more limited hint,
306     /// which still is useful, because it informs integer literals and the like.
307     /// See the test case `test/run-pass/coerce-expect-unsized.rs` and #20169
308     /// for examples of where this comes up,.
309     fn rvalue_hint(fcx: &FnCtxt<'a, 'gcx, 'tcx>, ty: Ty<'tcx>) -> Expectation<'tcx> {
310         match fcx.tcx.struct_tail(ty).sty {
311             ty::TySlice(_) | ty::TyStr | ty::TyDynamic(..) => {
312                 ExpectRvalueLikeUnsized(ty)
313             }
314             _ => ExpectHasType(ty)
315         }
316     }
317
318     // Resolves `expected` by a single level if it is a variable. If
319     // there is no expected type or resolution is not possible (e.g.,
320     // no constraints yet present), just returns `None`.
321     fn resolve(self, fcx: &FnCtxt<'a, 'gcx, 'tcx>) -> Expectation<'tcx> {
322         match self {
323             NoExpectation => NoExpectation,
324             ExpectIfCondition => ExpectIfCondition,
325             ExpectCastableToType(t) => {
326                 ExpectCastableToType(fcx.resolve_type_vars_if_possible(&t))
327             }
328             ExpectHasType(t) => {
329                 ExpectHasType(fcx.resolve_type_vars_if_possible(&t))
330             }
331             ExpectRvalueLikeUnsized(t) => {
332                 ExpectRvalueLikeUnsized(fcx.resolve_type_vars_if_possible(&t))
333             }
334         }
335     }
336
337     fn to_option(self, fcx: &FnCtxt<'a, 'gcx, 'tcx>) -> Option<Ty<'tcx>> {
338         match self.resolve(fcx) {
339             NoExpectation => None,
340             ExpectIfCondition => Some(fcx.tcx.types.bool),
341             ExpectCastableToType(ty) |
342             ExpectHasType(ty) |
343             ExpectRvalueLikeUnsized(ty) => Some(ty),
344         }
345     }
346
347     /// It sometimes happens that we want to turn an expectation into
348     /// a **hard constraint** (i.e., something that must be satisfied
349     /// for the program to type-check). `only_has_type` will return
350     /// such a constraint, if it exists.
351     fn only_has_type(self, fcx: &FnCtxt<'a, 'gcx, 'tcx>) -> Option<Ty<'tcx>> {
352         match self.resolve(fcx) {
353             ExpectHasType(ty) => Some(ty),
354             ExpectIfCondition => Some(fcx.tcx.types.bool),
355             NoExpectation | ExpectCastableToType(_) | ExpectRvalueLikeUnsized(_) => None,
356         }
357     }
358
359     /// Like `only_has_type`, but instead of returning `None` if no
360     /// hard constraint exists, creates a fresh type variable.
361     fn coercion_target_type(self, fcx: &FnCtxt<'a, 'gcx, 'tcx>, span: Span) -> Ty<'tcx> {
362         self.only_has_type(fcx)
363             .unwrap_or_else(|| fcx.next_ty_var(TypeVariableOrigin::MiscVariable(span)))
364     }
365 }
366
367 #[derive(Copy, Clone)]
368 pub struct UnsafetyState {
369     pub def: ast::NodeId,
370     pub unsafety: hir::Unsafety,
371     pub unsafe_push_count: u32,
372     from_fn: bool
373 }
374
375 impl UnsafetyState {
376     pub fn function(unsafety: hir::Unsafety, def: ast::NodeId) -> UnsafetyState {
377         UnsafetyState { def: def, unsafety: unsafety, unsafe_push_count: 0, from_fn: true }
378     }
379
380     pub fn recurse(&mut self, blk: &hir::Block) -> UnsafetyState {
381         match self.unsafety {
382             // If this unsafe, then if the outer function was already marked as
383             // unsafe we shouldn't attribute the unsafe'ness to the block. This
384             // way the block can be warned about instead of ignoring this
385             // extraneous block (functions are never warned about).
386             hir::Unsafety::Unsafe if self.from_fn => *self,
387
388             unsafety => {
389                 let (unsafety, def, count) = match blk.rules {
390                     hir::PushUnsafeBlock(..) =>
391                         (unsafety, blk.id, self.unsafe_push_count.checked_add(1).unwrap()),
392                     hir::PopUnsafeBlock(..) =>
393                         (unsafety, blk.id, self.unsafe_push_count.checked_sub(1).unwrap()),
394                     hir::UnsafeBlock(..) =>
395                         (hir::Unsafety::Unsafe, blk.id, self.unsafe_push_count),
396                     hir::DefaultBlock =>
397                         (unsafety, self.def, self.unsafe_push_count),
398                 };
399                 UnsafetyState{ def,
400                                unsafety,
401                                unsafe_push_count: count,
402                                from_fn: false }
403             }
404         }
405     }
406 }
407
408 #[derive(Debug, Copy, Clone)]
409 pub enum LvalueOp {
410     Deref,
411     Index
412 }
413
414 /// Tracks whether executing a node may exit normally (versus
415 /// return/break/panic, which "diverge", leaving dead code in their
416 /// wake). Tracked semi-automatically (through type variables marked
417 /// as diverging), with some manual adjustments for control-flow
418 /// primitives (approximating a CFG).
419 #[derive(Copy, Clone, Debug, PartialEq, Eq, PartialOrd, Ord)]
420 pub enum Diverges {
421     /// Potentially unknown, some cases converge,
422     /// others require a CFG to determine them.
423     Maybe,
424
425     /// Definitely known to diverge and therefore
426     /// not reach the next sibling or its parent.
427     Always,
428
429     /// Same as `Always` but with a reachability
430     /// warning already emitted
431     WarnedAlways
432 }
433
434 // Convenience impls for combinig `Diverges`.
435
436 impl ops::BitAnd for Diverges {
437     type Output = Self;
438     fn bitand(self, other: Self) -> Self {
439         cmp::min(self, other)
440     }
441 }
442
443 impl ops::BitOr for Diverges {
444     type Output = Self;
445     fn bitor(self, other: Self) -> Self {
446         cmp::max(self, other)
447     }
448 }
449
450 impl ops::BitAndAssign for Diverges {
451     fn bitand_assign(&mut self, other: Self) {
452         *self = *self & other;
453     }
454 }
455
456 impl ops::BitOrAssign for Diverges {
457     fn bitor_assign(&mut self, other: Self) {
458         *self = *self | other;
459     }
460 }
461
462 impl Diverges {
463     fn always(self) -> bool {
464         self >= Diverges::Always
465     }
466 }
467
468 pub struct BreakableCtxt<'gcx: 'tcx, 'tcx> {
469     may_break: bool,
470
471     // this is `null` for loops where break with a value is illegal,
472     // such as `while`, `for`, and `while let`
473     coerce: Option<DynamicCoerceMany<'gcx, 'tcx>>,
474 }
475
476 pub struct EnclosingBreakables<'gcx: 'tcx, 'tcx> {
477     stack: Vec<BreakableCtxt<'gcx, 'tcx>>,
478     by_id: NodeMap<usize>,
479 }
480
481 impl<'gcx, 'tcx> EnclosingBreakables<'gcx, 'tcx> {
482     fn find_breakable(&mut self, target_id: ast::NodeId) -> &mut BreakableCtxt<'gcx, 'tcx> {
483         let ix = *self.by_id.get(&target_id).unwrap_or_else(|| {
484             bug!("could not find enclosing breakable with id {}", target_id);
485         });
486         &mut self.stack[ix]
487     }
488 }
489
490 pub struct FnCtxt<'a, 'gcx: 'a+'tcx, 'tcx: 'a> {
491     body_id: ast::NodeId,
492
493     /// The parameter environment used for proving trait obligations
494     /// in this function. This can change when we descend into
495     /// closures (as they bring new things into scope), hence it is
496     /// not part of `Inherited` (as of the time of this writing,
497     /// closures do not yet change the environment, but they will
498     /// eventually).
499     param_env: ty::ParamEnv<'tcx>,
500
501     // Number of errors that had been reported when we started
502     // checking this function. On exit, if we find that *more* errors
503     // have been reported, we will skip regionck and other work that
504     // expects the types within the function to be consistent.
505     err_count_on_creation: usize,
506
507     ret_coercion: Option<RefCell<DynamicCoerceMany<'gcx, 'tcx>>>,
508
509     yield_ty: Option<Ty<'tcx>>,
510
511     ps: RefCell<UnsafetyState>,
512
513     /// Whether the last checked node generates a divergence (e.g.,
514     /// `return` will set this to Always). In general, when entering
515     /// an expression or other node in the tree, the initial value
516     /// indicates whether prior parts of the containing expression may
517     /// have diverged. It is then typically set to `Maybe` (and the
518     /// old value remembered) for processing the subparts of the
519     /// current expression. As each subpart is processed, they may set
520     /// the flag to `Always` etc.  Finally, at the end, we take the
521     /// result and "union" it with the original value, so that when we
522     /// return the flag indicates if any subpart of the the parent
523     /// expression (up to and including this part) has diverged.  So,
524     /// if you read it after evaluating a subexpression `X`, the value
525     /// you get indicates whether any subexpression that was
526     /// evaluating up to and including `X` diverged.
527     ///
528     /// We use this flag for two purposes:
529     ///
530     /// - To warn about unreachable code: if, after processing a
531     ///   sub-expression but before we have applied the effects of the
532     ///   current node, we see that the flag is set to `Always`, we
533     ///   can issue a warning. This corresponds to something like
534     ///   `foo(return)`; we warn on the `foo()` expression. (We then
535     ///   update the flag to `WarnedAlways` to suppress duplicate
536     ///   reports.) Similarly, if we traverse to a fresh statement (or
537     ///   tail expression) from a `Always` setting, we will issue a
538     ///   warning. This corresponds to something like `{return;
539     ///   foo();}` or `{return; 22}`, where we would warn on the
540     ///   `foo()` or `22`.
541     ///
542     /// - To permit assignment into a local variable or other lvalue
543     ///   (including the "return slot") of type `!`.  This is allowed
544     ///   if **either** the type of value being assigned is `!`, which
545     ///   means the current code is dead, **or** the expression's
546     ///   diverging flag is true, which means that a diverging value was
547     ///   wrapped (e.g., `let x: ! = foo(return)`).
548     ///
549     /// To repeat the last point: an expression represents dead-code
550     /// if, after checking it, **either** its type is `!` OR the
551     /// diverges flag is set to something other than `Maybe`.
552     diverges: Cell<Diverges>,
553
554     /// Whether any child nodes have any type errors.
555     has_errors: Cell<bool>,
556
557     enclosing_breakables: RefCell<EnclosingBreakables<'gcx, 'tcx>>,
558
559     inh: &'a Inherited<'a, 'gcx, 'tcx>,
560 }
561
562 impl<'a, 'gcx, 'tcx> Deref for FnCtxt<'a, 'gcx, 'tcx> {
563     type Target = Inherited<'a, 'gcx, 'tcx>;
564     fn deref(&self) -> &Self::Target {
565         &self.inh
566     }
567 }
568
569 /// Helper type of a temporary returned by Inherited::build(...).
570 /// Necessary because we can't write the following bound:
571 /// F: for<'b, 'tcx> where 'gcx: 'tcx FnOnce(Inherited<'b, 'gcx, 'tcx>).
572 pub struct InheritedBuilder<'a, 'gcx: 'a+'tcx, 'tcx: 'a> {
573     infcx: infer::InferCtxtBuilder<'a, 'gcx, 'tcx>,
574     def_id: DefId,
575 }
576
577 impl<'a, 'gcx, 'tcx> Inherited<'a, 'gcx, 'tcx> {
578     pub fn build(tcx: TyCtxt<'a, 'gcx, 'gcx>, def_id: DefId)
579                  -> InheritedBuilder<'a, 'gcx, 'tcx> {
580         let hir_id_root = if def_id.is_local() {
581             let node_id = tcx.hir.as_local_node_id(def_id).unwrap();
582             let hir_id = tcx.hir.definitions().node_to_hir_id(node_id);
583             DefId::local(hir_id.owner)
584         } else {
585             def_id
586         };
587
588         InheritedBuilder {
589             infcx: tcx.infer_ctxt().with_fresh_in_progress_tables(hir_id_root),
590             def_id,
591         }
592     }
593 }
594
595 impl<'a, 'gcx, 'tcx> InheritedBuilder<'a, 'gcx, 'tcx> {
596     fn enter<F, R>(&'tcx mut self, f: F) -> R
597         where F: for<'b> FnOnce(Inherited<'b, 'gcx, 'tcx>) -> R
598     {
599         let def_id = self.def_id;
600         self.infcx.enter(|infcx| f(Inherited::new(infcx, def_id)))
601     }
602 }
603
604 impl<'a, 'gcx, 'tcx> Inherited<'a, 'gcx, 'tcx> {
605     fn new(infcx: InferCtxt<'a, 'gcx, 'tcx>, def_id: DefId) -> Self {
606         let tcx = infcx.tcx;
607         let item_id = tcx.hir.as_local_node_id(def_id);
608         let body_id = item_id.and_then(|id| tcx.hir.maybe_body_owned_by(id));
609         let implicit_region_bound = body_id.map(|body_id| {
610             let body = tcx.hir.body(body_id);
611             tcx.mk_region(ty::ReScope(region::Scope::CallSite(body.value.hir_id.local_id)))
612         });
613
614         Inherited {
615             tables: MaybeInProgressTables {
616                 maybe_tables: infcx.in_progress_tables,
617             },
618             infcx,
619             fulfillment_cx: RefCell::new(traits::FulfillmentContext::new()),
620             locals: RefCell::new(NodeMap()),
621             deferred_call_resolutions: RefCell::new(DefIdMap()),
622             deferred_cast_checks: RefCell::new(Vec::new()),
623             deferred_generator_interiors: RefCell::new(Vec::new()),
624             anon_types: RefCell::new(NodeMap()),
625             implicit_region_bound,
626             body_id,
627         }
628     }
629
630     fn register_predicate(&self, obligation: traits::PredicateObligation<'tcx>) {
631         debug!("register_predicate({:?})", obligation);
632         if obligation.has_escaping_regions() {
633             span_bug!(obligation.cause.span, "escaping regions in predicate {:?}",
634                       obligation);
635         }
636         self.fulfillment_cx
637             .borrow_mut()
638             .register_predicate_obligation(self, obligation);
639     }
640
641     fn register_predicates<I>(&self, obligations: I)
642     where I: IntoIterator<Item = traits::PredicateObligation<'tcx>> {
643         for obligation in obligations {
644             self.register_predicate(obligation);
645         }
646     }
647
648     fn register_infer_ok_obligations<T>(&self, infer_ok: InferOk<'tcx, T>) -> T {
649         self.register_predicates(infer_ok.obligations);
650         infer_ok.value
651     }
652
653     fn normalize_associated_types_in<T>(&self,
654                                         span: Span,
655                                         body_id: ast::NodeId,
656                                         param_env: ty::ParamEnv<'tcx>,
657                                         value: &T) -> T
658         where T : TypeFoldable<'tcx>
659     {
660         let ok = self.normalize_associated_types_in_as_infer_ok(span, body_id, param_env, value);
661         self.register_infer_ok_obligations(ok)
662     }
663
664     fn normalize_associated_types_in_as_infer_ok<T>(&self,
665                                                     span: Span,
666                                                     body_id: ast::NodeId,
667                                                     param_env: ty::ParamEnv<'tcx>,
668                                                     value: &T)
669                                                     -> InferOk<'tcx, T>
670         where T : TypeFoldable<'tcx>
671     {
672         debug!("normalize_associated_types_in(value={:?})", value);
673         let mut selcx = traits::SelectionContext::new(self);
674         let cause = ObligationCause::misc(span, body_id);
675         let traits::Normalized { value, obligations } =
676             traits::normalize(&mut selcx, param_env, cause, value);
677         debug!("normalize_associated_types_in: result={:?} predicates={:?}",
678             value,
679             obligations);
680         InferOk { value, obligations }
681     }
682
683     /// Replace any late-bound regions bound in `value` with
684     /// free variants attached to `all_outlive_scope`.
685     fn liberate_late_bound_regions<T>(&self,
686         all_outlive_scope: DefId,
687         value: &ty::Binder<T>)
688         -> T
689         where T: TypeFoldable<'tcx>
690     {
691         self.tcx.replace_late_bound_regions(value, |br| {
692             self.tcx.mk_region(ty::ReFree(ty::FreeRegion {
693                 scope: all_outlive_scope,
694                 bound_region: br
695             }))
696         }).0
697     }
698 }
699
700 struct CheckItemTypesVisitor<'a, 'tcx: 'a> { tcx: TyCtxt<'a, 'tcx, 'tcx> }
701
702 impl<'a, 'tcx> ItemLikeVisitor<'tcx> for CheckItemTypesVisitor<'a, 'tcx> {
703     fn visit_item(&mut self, i: &'tcx hir::Item) {
704         check_item_type(self.tcx, i);
705     }
706     fn visit_trait_item(&mut self, _: &'tcx hir::TraitItem) { }
707     fn visit_impl_item(&mut self, _: &'tcx hir::ImplItem) { }
708 }
709
710 pub fn check_wf_new<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>) -> Result<(), ErrorReported> {
711     tcx.sess.track_errors(|| {
712         let mut visit = wfcheck::CheckTypeWellFormedVisitor::new(tcx);
713         tcx.hir.krate().visit_all_item_likes(&mut visit.as_deep_visitor());
714     })
715 }
716
717 pub fn check_item_types<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>) -> Result<(), ErrorReported> {
718     tcx.sess.track_errors(|| {
719         tcx.hir.krate().visit_all_item_likes(&mut CheckItemTypesVisitor { tcx });
720     })
721 }
722
723 pub fn check_item_bodies<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>) -> Result<(), CompileIncomplete> {
724     tcx.typeck_item_bodies(LOCAL_CRATE)
725 }
726
727 fn typeck_item_bodies<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>, crate_num: CrateNum)
728                                 -> Result<(), CompileIncomplete>
729 {
730     debug_assert!(crate_num == LOCAL_CRATE);
731     Ok(tcx.sess.track_errors(|| {
732         for body_owner_def_id in tcx.body_owners() {
733             ty::maps::queries::typeck_tables_of::ensure(tcx, body_owner_def_id);
734         }
735     })?)
736 }
737
738 pub fn provide(providers: &mut Providers) {
739     *providers = Providers {
740         typeck_item_bodies,
741         typeck_tables_of,
742         has_typeck_tables,
743         closure_kind,
744         generator_sig,
745         adt_destructor,
746         used_trait_imports,
747         ..*providers
748     };
749 }
750
751 fn generator_sig<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
752                           def_id: DefId)
753                           -> Option<ty::PolyGenSig<'tcx>> {
754     let node_id = tcx.hir.as_local_node_id(def_id).unwrap();
755     let hir_id = tcx.hir.node_to_hir_id(node_id);
756     tcx.typeck_tables_of(def_id).generator_sigs()[hir_id].map(|s| ty::Binder(s))
757 }
758
759 fn closure_kind<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
760                           def_id: DefId)
761                           -> ty::ClosureKind {
762     let node_id = tcx.hir.as_local_node_id(def_id).unwrap();
763     let hir_id = tcx.hir.node_to_hir_id(node_id);
764     tcx.typeck_tables_of(def_id).closure_kinds()[hir_id].0
765 }
766
767 fn adt_destructor<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
768                             def_id: DefId)
769                             -> Option<ty::Destructor> {
770     tcx.calculate_dtor(def_id, &mut dropck::check_drop_impl)
771 }
772
773 /// If this def-id is a "primary tables entry", returns `Some((body_id, decl))`
774 /// with information about it's body-id and fn-decl (if any). Otherwise,
775 /// returns `None`.
776 ///
777 /// If this function returns "some", then `typeck_tables(def_id)` will
778 /// succeed; if it returns `None`, then `typeck_tables(def_id)` may or
779 /// may not succeed.  In some cases where this function returns `None`
780 /// (notably closures), `typeck_tables(def_id)` would wind up
781 /// redirecting to the owning function.
782 fn primary_body_of<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
783                              id: ast::NodeId)
784                              -> Option<(hir::BodyId, Option<&'tcx hir::FnDecl>)>
785 {
786     match tcx.hir.get(id) {
787         hir::map::NodeItem(item) => {
788             match item.node {
789                 hir::ItemConst(_, body) |
790                 hir::ItemStatic(_, _, body) =>
791                     Some((body, None)),
792                 hir::ItemFn(ref decl, .., body) =>
793                     Some((body, Some(decl))),
794                 _ =>
795                     None,
796             }
797         }
798         hir::map::NodeTraitItem(item) => {
799             match item.node {
800                 hir::TraitItemKind::Const(_, Some(body)) =>
801                     Some((body, None)),
802                 hir::TraitItemKind::Method(ref sig, hir::TraitMethod::Provided(body)) =>
803                     Some((body, Some(&sig.decl))),
804                 _ =>
805                     None,
806             }
807         }
808         hir::map::NodeImplItem(item) => {
809             match item.node {
810                 hir::ImplItemKind::Const(_, body) =>
811                     Some((body, None)),
812                 hir::ImplItemKind::Method(ref sig, body) =>
813                     Some((body, Some(&sig.decl))),
814                 _ =>
815                     None,
816             }
817         }
818         hir::map::NodeExpr(expr) => {
819             // FIXME(eddyb) Closures should have separate
820             // function definition IDs and expression IDs.
821             // Type-checking should not let closures get
822             // this far in a constant position.
823             // Assume that everything other than closures
824             // is a constant "initializer" expression.
825             match expr.node {
826                 hir::ExprClosure(..) =>
827                     None,
828                 _ =>
829                     Some((hir::BodyId { node_id: expr.id }, None)),
830             }
831         }
832         _ => None,
833     }
834 }
835
836 fn has_typeck_tables<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
837                                def_id: DefId)
838                                -> bool {
839     // Closures' tables come from their outermost function,
840     // as they are part of the same "inference environment".
841     let outer_def_id = tcx.closure_base_def_id(def_id);
842     if outer_def_id != def_id {
843         return tcx.has_typeck_tables(outer_def_id);
844     }
845
846     let id = tcx.hir.as_local_node_id(def_id).unwrap();
847     primary_body_of(tcx, id).is_some()
848 }
849
850 fn used_trait_imports<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
851                               def_id: DefId)
852                               -> Rc<DefIdSet> {
853     tcx.typeck_tables_of(def_id).used_trait_imports.clone()
854 }
855
856 fn typeck_tables_of<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
857                               def_id: DefId)
858                               -> &'tcx ty::TypeckTables<'tcx> {
859     // Closures' tables come from their outermost function,
860     // as they are part of the same "inference environment".
861     let outer_def_id = tcx.closure_base_def_id(def_id);
862     if outer_def_id != def_id {
863         return tcx.typeck_tables_of(outer_def_id);
864     }
865
866     let id = tcx.hir.as_local_node_id(def_id).unwrap();
867     let span = tcx.hir.span(id);
868
869     // Figure out what primary body this item has.
870     let (body_id, fn_decl) = primary_body_of(tcx, id).unwrap_or_else(|| {
871         span_bug!(span, "can't type-check body of {:?}", def_id);
872     });
873     let body = tcx.hir.body(body_id);
874
875     let tables = Inherited::build(tcx, def_id).enter(|inh| {
876         let param_env = tcx.param_env(def_id);
877         let fcx = if let Some(decl) = fn_decl {
878             let fn_sig = tcx.fn_sig(def_id);
879
880             check_abi(tcx, span, fn_sig.abi());
881
882             // Compute the fty from point of view of inside fn.
883             let fn_sig =
884                 inh.liberate_late_bound_regions(def_id, &fn_sig);
885             let fn_sig =
886                 inh.normalize_associated_types_in(body.value.span,
887                                                   body_id.node_id,
888                                                   param_env,
889                                                   &fn_sig);
890
891             check_fn(&inh, param_env, fn_sig, decl, id, body, false).0
892         } else {
893             let fcx = FnCtxt::new(&inh, param_env, body.value.id);
894             let expected_type = tcx.type_of(def_id);
895             let expected_type = fcx.normalize_associated_types_in(body.value.span, &expected_type);
896             fcx.require_type_is_sized(expected_type, body.value.span, traits::ConstSized);
897
898             // Gather locals in statics (because of block expressions).
899             // This is technically unnecessary because locals in static items are forbidden,
900             // but prevents type checking from blowing up before const checking can properly
901             // emit an error.
902             GatherLocalsVisitor { fcx: &fcx }.visit_body(body);
903
904             fcx.check_expr_coercable_to_type(&body.value, expected_type);
905
906             fcx
907         };
908
909         fcx.select_all_obligations_and_apply_defaults();
910         fcx.closure_analyze(body);
911         fcx.select_obligations_where_possible();
912         fcx.check_casts();
913         fcx.resolve_generator_interiors(def_id);
914         fcx.select_all_obligations_or_error();
915
916         if fn_decl.is_some() {
917             fcx.regionck_fn(id, body);
918         } else {
919             fcx.regionck_expr(body);
920         }
921
922         fcx.resolve_type_vars_in_body(body)
923     });
924
925     // Consistency check our TypeckTables instance can hold all ItemLocalIds
926     // it will need to hold.
927     assert_eq!(tables.local_id_root,
928                Some(DefId::local(tcx.hir.definitions().node_to_hir_id(id).owner)));
929     tables
930 }
931
932 fn check_abi<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>, span: Span, abi: Abi) {
933     if !tcx.sess.target.target.is_abi_supported(abi) {
934         struct_span_err!(tcx.sess, span, E0570,
935             "The ABI `{}` is not supported for the current target", abi).emit()
936     }
937 }
938
939 struct GatherLocalsVisitor<'a, 'gcx: 'a+'tcx, 'tcx: 'a> {
940     fcx: &'a FnCtxt<'a, 'gcx, 'tcx>
941 }
942
943 impl<'a, 'gcx, 'tcx> GatherLocalsVisitor<'a, 'gcx, 'tcx> {
944     fn assign(&mut self, span: Span, nid: ast::NodeId, ty_opt: Option<Ty<'tcx>>) -> Ty<'tcx> {
945         match ty_opt {
946             None => {
947                 // infer the variable's type
948                 let var_ty = self.fcx.next_ty_var(TypeVariableOrigin::TypeInference(span));
949                 self.fcx.locals.borrow_mut().insert(nid, var_ty);
950                 var_ty
951             }
952             Some(typ) => {
953                 // take type that the user specified
954                 self.fcx.locals.borrow_mut().insert(nid, typ);
955                 typ
956             }
957         }
958     }
959 }
960
961 impl<'a, 'gcx, 'tcx> Visitor<'gcx> for GatherLocalsVisitor<'a, 'gcx, 'tcx> {
962     fn nested_visit_map<'this>(&'this mut self) -> NestedVisitorMap<'this, 'gcx> {
963         NestedVisitorMap::None
964     }
965
966     // Add explicitly-declared locals.
967     fn visit_local(&mut self, local: &'gcx hir::Local) {
968         let o_ty = match local.ty {
969             Some(ref ty) => Some(self.fcx.to_ty(&ty)),
970             None => None
971         };
972         self.assign(local.span, local.id, o_ty);
973         debug!("Local variable {:?} is assigned type {}",
974                local.pat,
975                self.fcx.ty_to_string(
976                    self.fcx.locals.borrow().get(&local.id).unwrap().clone()));
977         intravisit::walk_local(self, local);
978     }
979
980     // Add pattern bindings.
981     fn visit_pat(&mut self, p: &'gcx hir::Pat) {
982         if let PatKind::Binding(_, _, ref path1, _) = p.node {
983             let var_ty = self.assign(p.span, p.id, None);
984
985             self.fcx.require_type_is_sized(var_ty, p.span,
986                                            traits::VariableType(p.id));
987
988             debug!("Pattern binding {} is assigned to {} with type {:?}",
989                    path1.node,
990                    self.fcx.ty_to_string(
991                        self.fcx.locals.borrow().get(&p.id).unwrap().clone()),
992                    var_ty);
993         }
994         intravisit::walk_pat(self, p);
995     }
996
997     // Don't descend into the bodies of nested closures
998     fn visit_fn(&mut self, _: intravisit::FnKind<'gcx>, _: &'gcx hir::FnDecl,
999                 _: hir::BodyId, _: Span, _: ast::NodeId) { }
1000 }
1001
1002 /// Helper used for fns and closures. Does the grungy work of checking a function
1003 /// body and returns the function context used for that purpose, since in the case of a fn item
1004 /// there is still a bit more to do.
1005 ///
1006 /// * ...
1007 /// * inherited: other fields inherited from the enclosing fn (if any)
1008 fn check_fn<'a, 'gcx, 'tcx>(inherited: &'a Inherited<'a, 'gcx, 'tcx>,
1009                             param_env: ty::ParamEnv<'tcx>,
1010                             fn_sig: ty::FnSig<'tcx>,
1011                             decl: &'gcx hir::FnDecl,
1012                             fn_id: ast::NodeId,
1013                             body: &'gcx hir::Body,
1014                             can_be_generator: bool)
1015                             -> (FnCtxt<'a, 'gcx, 'tcx>, Option<ty::GeneratorInterior<'tcx>>)
1016 {
1017     let mut fn_sig = fn_sig.clone();
1018
1019     debug!("check_fn(sig={:?}, fn_id={}, param_env={:?})", fn_sig, fn_id, param_env);
1020
1021     // Create the function context.  This is either derived from scratch or,
1022     // in the case of function expressions, based on the outer context.
1023     let mut fcx = FnCtxt::new(inherited, param_env, body.value.id);
1024     *fcx.ps.borrow_mut() = UnsafetyState::function(fn_sig.unsafety, fn_id);
1025
1026     let ret_ty = fn_sig.output();
1027     fcx.require_type_is_sized(ret_ty, decl.output.span(), traits::SizedReturnType);
1028     let ret_ty = fcx.instantiate_anon_types(&ret_ty);
1029     fcx.ret_coercion = Some(RefCell::new(CoerceMany::new(ret_ty)));
1030     fn_sig = fcx.tcx.mk_fn_sig(
1031         fn_sig.inputs().iter().cloned(),
1032         ret_ty,
1033         fn_sig.variadic,
1034         fn_sig.unsafety,
1035         fn_sig.abi
1036     );
1037
1038     let span = body.value.span;
1039
1040     if body.is_generator && can_be_generator {
1041         fcx.yield_ty = Some(fcx.next_ty_var(TypeVariableOrigin::TypeInference(span)));
1042     }
1043
1044     GatherLocalsVisitor { fcx: &fcx, }.visit_body(body);
1045
1046     // Add formal parameters.
1047     for (arg_ty, arg) in fn_sig.inputs().iter().zip(&body.arguments) {
1048         // Check the pattern.
1049         fcx.check_pat_walk(&arg.pat, arg_ty,
1050             ty::BindingMode::BindByValue(hir::Mutability::MutImmutable), true);
1051
1052         // Check that argument is Sized.
1053         // The check for a non-trivial pattern is a hack to avoid duplicate warnings
1054         // for simple cases like `fn foo(x: Trait)`,
1055         // where we would error once on the parameter as a whole, and once on the binding `x`.
1056         if arg.pat.simple_name().is_none() {
1057             fcx.require_type_is_sized(arg_ty, decl.output.span(), traits::MiscObligation);
1058         }
1059
1060         fcx.write_ty(arg.hir_id, arg_ty);
1061     }
1062
1063     let fn_hir_id = fcx.tcx.hir.node_to_hir_id(fn_id);
1064     let gen_ty = if can_be_generator && body.is_generator {
1065         let gen_sig = ty::GenSig {
1066             yield_ty: fcx.yield_ty.unwrap(),
1067             return_ty: ret_ty,
1068         };
1069         inherited.tables.borrow_mut().generator_sigs_mut().insert(fn_hir_id, Some(gen_sig));
1070
1071         let witness = fcx.next_ty_var(TypeVariableOrigin::MiscVariable(span));
1072         fcx.deferred_generator_interiors.borrow_mut().push((body.id(), witness));
1073         let interior = ty::GeneratorInterior::new(witness);
1074
1075         inherited.tables.borrow_mut().generator_interiors_mut().insert(fn_hir_id, interior);
1076
1077         Some(interior)
1078     } else {
1079         inherited.tables.borrow_mut().generator_sigs_mut().insert(fn_hir_id, None);
1080         None
1081     };
1082     inherited.tables.borrow_mut().liberated_fn_sigs_mut().insert(fn_hir_id, fn_sig);
1083
1084     fcx.check_return_expr(&body.value);
1085
1086     // Finalize the return check by taking the LUB of the return types
1087     // we saw and assigning it to the expected return type. This isn't
1088     // really expected to fail, since the coercions would have failed
1089     // earlier when trying to find a LUB.
1090     //
1091     // However, the behavior around `!` is sort of complex. In the
1092     // event that the `actual_return_ty` comes back as `!`, that
1093     // indicates that the fn either does not return or "returns" only
1094     // values of type `!`. In this case, if there is an expected
1095     // return type that is *not* `!`, that should be ok. But if the
1096     // return type is being inferred, we want to "fallback" to `!`:
1097     //
1098     //     let x = move || panic!();
1099     //
1100     // To allow for that, I am creating a type variable with diverging
1101     // fallback. This was deemed ever so slightly better than unifying
1102     // the return value with `!` because it allows for the caller to
1103     // make more assumptions about the return type (e.g., they could do
1104     //
1105     //     let y: Option<u32> = Some(x());
1106     //
1107     // which would then cause this return type to become `u32`, not
1108     // `!`).
1109     let coercion = fcx.ret_coercion.take().unwrap().into_inner();
1110     let mut actual_return_ty = coercion.complete(&fcx);
1111     if actual_return_ty.is_never() {
1112         actual_return_ty = fcx.next_diverging_ty_var(
1113             TypeVariableOrigin::DivergingFn(span));
1114     }
1115     fcx.demand_suptype(span, ret_ty, actual_return_ty);
1116
1117     (fcx, gen_ty)
1118 }
1119
1120 fn check_struct<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1121                           id: ast::NodeId,
1122                           span: Span) {
1123     let def_id = tcx.hir.local_def_id(id);
1124     let def = tcx.adt_def(def_id);
1125     def.destructor(tcx); // force the destructor to be evaluated
1126     check_representable(tcx, span, def_id);
1127
1128     if def.repr.simd() {
1129         check_simd(tcx, span, def_id);
1130     }
1131
1132     check_packed(tcx, span, def_id);
1133 }
1134
1135 fn check_union<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1136                          id: ast::NodeId,
1137                          span: Span) {
1138     let def_id = tcx.hir.local_def_id(id);
1139     let def = tcx.adt_def(def_id);
1140     def.destructor(tcx); // force the destructor to be evaluated
1141     check_representable(tcx, span, def_id);
1142
1143     check_packed(tcx, span, def_id);
1144 }
1145
1146 pub fn check_item_type<'a,'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>, it: &'tcx hir::Item) {
1147     debug!("check_item_type(it.id={}, it.name={})",
1148            it.id,
1149            tcx.item_path_str(tcx.hir.local_def_id(it.id)));
1150     let _indenter = indenter();
1151     match it.node {
1152       // Consts can play a role in type-checking, so they are included here.
1153       hir::ItemStatic(..) |
1154       hir::ItemConst(..) => {
1155         tcx.typeck_tables_of(tcx.hir.local_def_id(it.id));
1156       }
1157       hir::ItemEnum(ref enum_definition, _) => {
1158         check_enum(tcx,
1159                    it.span,
1160                    &enum_definition.variants,
1161                    it.id);
1162       }
1163       hir::ItemFn(..) => {} // entirely within check_item_body
1164       hir::ItemImpl(.., ref impl_item_refs) => {
1165           debug!("ItemImpl {} with id {}", it.name, it.id);
1166           let impl_def_id = tcx.hir.local_def_id(it.id);
1167           if let Some(impl_trait_ref) = tcx.impl_trait_ref(impl_def_id) {
1168               check_impl_items_against_trait(tcx,
1169                                              it.span,
1170                                              impl_def_id,
1171                                              impl_trait_ref,
1172                                              impl_item_refs);
1173               let trait_def_id = impl_trait_ref.def_id;
1174               check_on_unimplemented(tcx, trait_def_id, it);
1175           }
1176       }
1177       hir::ItemTrait(..) => {
1178         let def_id = tcx.hir.local_def_id(it.id);
1179         check_on_unimplemented(tcx, def_id, it);
1180       }
1181       hir::ItemStruct(..) => {
1182         check_struct(tcx, it.id, it.span);
1183       }
1184       hir::ItemUnion(..) => {
1185         check_union(tcx, it.id, it.span);
1186       }
1187       hir::ItemTy(_, ref generics) => {
1188         let def_id = tcx.hir.local_def_id(it.id);
1189         let pty_ty = tcx.type_of(def_id);
1190         check_bounds_are_used(tcx, generics, pty_ty);
1191       }
1192       hir::ItemForeignMod(ref m) => {
1193         check_abi(tcx, it.span, m.abi);
1194
1195         if m.abi == Abi::RustIntrinsic {
1196             for item in &m.items {
1197                 intrinsic::check_intrinsic_type(tcx, item);
1198             }
1199         } else if m.abi == Abi::PlatformIntrinsic {
1200             for item in &m.items {
1201                 intrinsic::check_platform_intrinsic_type(tcx, item);
1202             }
1203         } else {
1204             for item in &m.items {
1205                 let generics = tcx.generics_of(tcx.hir.local_def_id(item.id));
1206                 if !generics.types.is_empty() {
1207                     let mut err = struct_span_err!(tcx.sess, item.span, E0044,
1208                         "foreign items may not have type parameters");
1209                     span_help!(&mut err, item.span,
1210                         "consider using specialization instead of \
1211                         type parameters");
1212                     err.emit();
1213                 }
1214
1215                 if let hir::ForeignItemFn(ref fn_decl, _, _) = item.node {
1216                     require_c_abi_if_variadic(tcx, fn_decl, m.abi, item.span);
1217                 }
1218             }
1219         }
1220       }
1221       _ => {/* nothing to do */ }
1222     }
1223 }
1224
1225 fn check_on_unimplemented<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1226                                     trait_def_id: DefId,
1227                                     item: &hir::Item) {
1228     let item_def_id = tcx.hir.local_def_id(item.id);
1229     // an error would be reported if this fails.
1230     let _ = traits::OnUnimplementedDirective::of_item(tcx, trait_def_id, item_def_id);
1231 }
1232
1233 fn report_forbidden_specialization<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1234                                              impl_item: &hir::ImplItem,
1235                                              parent_impl: DefId)
1236 {
1237     let mut err = struct_span_err!(
1238         tcx.sess, impl_item.span, E0520,
1239         "`{}` specializes an item from a parent `impl`, but \
1240          that item is not marked `default`",
1241         impl_item.name);
1242     err.span_label(impl_item.span, format!("cannot specialize default item `{}`",
1243                                             impl_item.name));
1244
1245     match tcx.span_of_impl(parent_impl) {
1246         Ok(span) => {
1247             err.span_label(span, "parent `impl` is here");
1248             err.note(&format!("to specialize, `{}` in the parent `impl` must be marked `default`",
1249                               impl_item.name));
1250         }
1251         Err(cname) => {
1252             err.note(&format!("parent implementation is in crate `{}`", cname));
1253         }
1254     }
1255
1256     err.emit();
1257 }
1258
1259 fn check_specialization_validity<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1260                                            trait_def: &ty::TraitDef,
1261                                            trait_item: &ty::AssociatedItem,
1262                                            impl_id: DefId,
1263                                            impl_item: &hir::ImplItem)
1264 {
1265     let ancestors = trait_def.ancestors(tcx, impl_id);
1266
1267     let kind = match impl_item.node {
1268         hir::ImplItemKind::Const(..) => ty::AssociatedKind::Const,
1269         hir::ImplItemKind::Method(..) => ty::AssociatedKind::Method,
1270         hir::ImplItemKind::Type(_) => ty::AssociatedKind::Type
1271     };
1272
1273     let parent = ancestors.defs(tcx, trait_item.name, kind, trait_def.def_id).skip(1).next()
1274         .map(|node_item| node_item.map(|parent| parent.defaultness));
1275
1276     if let Some(parent) = parent {
1277         if tcx.impl_item_is_final(&parent) {
1278             report_forbidden_specialization(tcx, impl_item, parent.node.def_id());
1279         }
1280     }
1281
1282 }
1283
1284 fn check_impl_items_against_trait<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1285                                             impl_span: Span,
1286                                             impl_id: DefId,
1287                                             impl_trait_ref: ty::TraitRef<'tcx>,
1288                                             impl_item_refs: &[hir::ImplItemRef]) {
1289     // If the trait reference itself is erroneous (so the compilation is going
1290     // to fail), skip checking the items here -- the `impl_item` table in `tcx`
1291     // isn't populated for such impls.
1292     if impl_trait_ref.references_error() { return; }
1293
1294     // Locate trait definition and items
1295     let trait_def = tcx.trait_def(impl_trait_ref.def_id);
1296     let mut overridden_associated_type = None;
1297
1298     let impl_items = || impl_item_refs.iter().map(|iiref| tcx.hir.impl_item(iiref.id));
1299
1300     // Check existing impl methods to see if they are both present in trait
1301     // and compatible with trait signature
1302     for impl_item in impl_items() {
1303         let ty_impl_item = tcx.associated_item(tcx.hir.local_def_id(impl_item.id));
1304         let ty_trait_item = tcx.associated_items(impl_trait_ref.def_id)
1305             .find(|ac| Namespace::from(&impl_item.node) == Namespace::from(ac.kind) &&
1306                          tcx.hygienic_eq(ty_impl_item.name, ac.name, impl_trait_ref.def_id))
1307             .or_else(|| {
1308                 // Not compatible, but needed for the error message
1309                 tcx.associated_items(impl_trait_ref.def_id)
1310                    .find(|ac| tcx.hygienic_eq(ty_impl_item.name, ac.name, impl_trait_ref.def_id))
1311             });
1312
1313         // Check that impl definition matches trait definition
1314         if let Some(ty_trait_item) = ty_trait_item {
1315             match impl_item.node {
1316                 hir::ImplItemKind::Const(..) => {
1317                     // Find associated const definition.
1318                     if ty_trait_item.kind == ty::AssociatedKind::Const {
1319                         compare_const_impl(tcx,
1320                                            &ty_impl_item,
1321                                            impl_item.span,
1322                                            &ty_trait_item,
1323                                            impl_trait_ref);
1324                     } else {
1325                          let mut err = struct_span_err!(tcx.sess, impl_item.span, E0323,
1326                                   "item `{}` is an associated const, \
1327                                   which doesn't match its trait `{}`",
1328                                   ty_impl_item.name,
1329                                   impl_trait_ref);
1330                          err.span_label(impl_item.span, "does not match trait");
1331                          // We can only get the spans from local trait definition
1332                          // Same for E0324 and E0325
1333                          if let Some(trait_span) = tcx.hir.span_if_local(ty_trait_item.def_id) {
1334                             err.span_label(trait_span, "item in trait");
1335                          }
1336                          err.emit()
1337                     }
1338                 }
1339                 hir::ImplItemKind::Method(..) => {
1340                     let trait_span = tcx.hir.span_if_local(ty_trait_item.def_id);
1341                     if ty_trait_item.kind == ty::AssociatedKind::Method {
1342                         let err_count = tcx.sess.err_count();
1343                         compare_impl_method(tcx,
1344                                             &ty_impl_item,
1345                                             impl_item.span,
1346                                             &ty_trait_item,
1347                                             impl_trait_ref,
1348                                             trait_span,
1349                                             true); // start with old-broken-mode
1350                         if err_count == tcx.sess.err_count() {
1351                             // old broken mode did not report an error. Try with the new mode.
1352                             compare_impl_method(tcx,
1353                                                 &ty_impl_item,
1354                                                 impl_item.span,
1355                                                 &ty_trait_item,
1356                                                 impl_trait_ref,
1357                                                 trait_span,
1358                                                 false); // use the new mode
1359                         }
1360                     } else {
1361                         let mut err = struct_span_err!(tcx.sess, impl_item.span, E0324,
1362                                   "item `{}` is an associated method, \
1363                                   which doesn't match its trait `{}`",
1364                                   ty_impl_item.name,
1365                                   impl_trait_ref);
1366                          err.span_label(impl_item.span, "does not match trait");
1367                          if let Some(trait_span) = tcx.hir.span_if_local(ty_trait_item.def_id) {
1368                             err.span_label(trait_span, "item in trait");
1369                          }
1370                          err.emit()
1371                     }
1372                 }
1373                 hir::ImplItemKind::Type(_) => {
1374                     if ty_trait_item.kind == ty::AssociatedKind::Type {
1375                         if ty_trait_item.defaultness.has_value() {
1376                             overridden_associated_type = Some(impl_item);
1377                         }
1378                     } else {
1379                         let mut err = struct_span_err!(tcx.sess, impl_item.span, E0325,
1380                                   "item `{}` is an associated type, \
1381                                   which doesn't match its trait `{}`",
1382                                   ty_impl_item.name,
1383                                   impl_trait_ref);
1384                          err.span_label(impl_item.span, "does not match trait");
1385                          if let Some(trait_span) = tcx.hir.span_if_local(ty_trait_item.def_id) {
1386                             err.span_label(trait_span, "item in trait");
1387                          }
1388                          err.emit()
1389                     }
1390                 }
1391             }
1392
1393             check_specialization_validity(tcx, trait_def, &ty_trait_item, impl_id, impl_item);
1394         }
1395     }
1396
1397     // Check for missing items from trait
1398     let mut missing_items = Vec::new();
1399     let mut invalidated_items = Vec::new();
1400     let associated_type_overridden = overridden_associated_type.is_some();
1401     for trait_item in tcx.associated_items(impl_trait_ref.def_id) {
1402         let is_implemented = trait_def.ancestors(tcx, impl_id)
1403             .defs(tcx, trait_item.name, trait_item.kind, impl_trait_ref.def_id)
1404             .next()
1405             .map(|node_item| !node_item.node.is_from_trait())
1406             .unwrap_or(false);
1407
1408         if !is_implemented {
1409             if !trait_item.defaultness.has_value() {
1410                 missing_items.push(trait_item);
1411             } else if associated_type_overridden {
1412                 invalidated_items.push(trait_item.name);
1413             }
1414         }
1415     }
1416
1417     if !missing_items.is_empty() {
1418         let mut err = struct_span_err!(tcx.sess, impl_span, E0046,
1419             "not all trait items implemented, missing: `{}`",
1420             missing_items.iter()
1421                   .map(|trait_item| trait_item.name.to_string())
1422                   .collect::<Vec<_>>().join("`, `"));
1423         err.span_label(impl_span, format!("missing `{}` in implementation",
1424                 missing_items.iter()
1425                     .map(|trait_item| trait_item.name.to_string())
1426                     .collect::<Vec<_>>().join("`, `")));
1427         for trait_item in missing_items {
1428             if let Some(span) = tcx.hir.span_if_local(trait_item.def_id) {
1429                 err.span_label(span, format!("`{}` from trait", trait_item.name));
1430             } else {
1431                 err.note_trait_signature(trait_item.name.to_string(),
1432                                          trait_item.signature(&tcx));
1433             }
1434         }
1435         err.emit();
1436     }
1437
1438     if !invalidated_items.is_empty() {
1439         let invalidator = overridden_associated_type.unwrap();
1440         span_err!(tcx.sess, invalidator.span, E0399,
1441                   "the following trait items need to be reimplemented \
1442                    as `{}` was overridden: `{}`",
1443                   invalidator.name,
1444                   invalidated_items.iter()
1445                                    .map(|name| name.to_string())
1446                                    .collect::<Vec<_>>().join("`, `"))
1447     }
1448 }
1449
1450 /// Checks whether a type can be represented in memory. In particular, it
1451 /// identifies types that contain themselves without indirection through a
1452 /// pointer, which would mean their size is unbounded.
1453 fn check_representable<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1454                                  sp: Span,
1455                                  item_def_id: DefId)
1456                                  -> bool {
1457     let rty = tcx.type_of(item_def_id);
1458
1459     // Check that it is possible to represent this type. This call identifies
1460     // (1) types that contain themselves and (2) types that contain a different
1461     // recursive type. It is only necessary to throw an error on those that
1462     // contain themselves. For case 2, there must be an inner type that will be
1463     // caught by case 1.
1464     match rty.is_representable(tcx, sp) {
1465         Representability::SelfRecursive(spans) => {
1466             let mut err = tcx.recursive_type_with_infinite_size_error(item_def_id);
1467             for span in spans {
1468                 err.span_label(span, "recursive without indirection");
1469             }
1470             err.emit();
1471             return false
1472         }
1473         Representability::Representable | Representability::ContainsRecursive => (),
1474     }
1475     return true
1476 }
1477
1478 pub fn check_simd<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>, sp: Span, def_id: DefId) {
1479     let t = tcx.type_of(def_id);
1480     match t.sty {
1481         ty::TyAdt(def, substs) if def.is_struct() => {
1482             let fields = &def.struct_variant().fields;
1483             if fields.is_empty() {
1484                 span_err!(tcx.sess, sp, E0075, "SIMD vector cannot be empty");
1485                 return;
1486             }
1487             let e = fields[0].ty(tcx, substs);
1488             if !fields.iter().all(|f| f.ty(tcx, substs) == e) {
1489                 struct_span_err!(tcx.sess, sp, E0076, "SIMD vector should be homogeneous")
1490                                 .span_label(sp, "SIMD elements must have the same type")
1491                                 .emit();
1492                 return;
1493             }
1494             match e.sty {
1495                 ty::TyParam(_) => { /* struct<T>(T, T, T, T) is ok */ }
1496                 _ if e.is_machine()  => { /* struct(u8, u8, u8, u8) is ok */ }
1497                 _ => {
1498                     span_err!(tcx.sess, sp, E0077,
1499                               "SIMD vector element type should be machine type");
1500                     return;
1501                 }
1502             }
1503         }
1504         _ => ()
1505     }
1506 }
1507
1508 fn check_packed<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>, sp: Span, def_id: DefId) {
1509     if tcx.adt_def(def_id).repr.packed() {
1510         if tcx.adt_def(def_id).repr.align > 0 {
1511             struct_span_err!(tcx.sess, sp, E0587,
1512                              "type has conflicting packed and align representation hints").emit();
1513         }
1514         else if check_packed_inner(tcx, def_id, &mut Vec::new()) {
1515             struct_span_err!(tcx.sess, sp, E0588,
1516                 "packed type cannot transitively contain a `[repr(align)]` type").emit();
1517         }
1518     }
1519 }
1520
1521 fn check_packed_inner<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1522                                 def_id: DefId,
1523                                 stack: &mut Vec<DefId>) -> bool {
1524     let t = tcx.type_of(def_id);
1525     if stack.contains(&def_id) {
1526         debug!("check_packed_inner: {:?} is recursive", t);
1527         return false;
1528     }
1529     match t.sty {
1530         ty::TyAdt(def, substs) if def.is_struct() || def.is_union() => {
1531             if tcx.adt_def(def.did).repr.align > 0 {
1532                 return true;
1533             }
1534             // push struct def_id before checking fields
1535             stack.push(def_id);
1536             for field in &def.struct_variant().fields {
1537                 let f = field.ty(tcx, substs);
1538                 match f.sty {
1539                     ty::TyAdt(def, _) => {
1540                         if check_packed_inner(tcx, def.did, stack) {
1541                             return true;
1542                         }
1543                     }
1544                     _ => ()
1545                 }
1546             }
1547             // only need to pop if not early out
1548             stack.pop();
1549         }
1550         _ => ()
1551     }
1552     false
1553 }
1554
1555 #[allow(trivial_numeric_casts)]
1556 pub fn check_enum<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
1557                             sp: Span,
1558                             vs: &'tcx [hir::Variant],
1559                             id: ast::NodeId) {
1560     let def_id = tcx.hir.local_def_id(id);
1561     let def = tcx.adt_def(def_id);
1562     def.destructor(tcx); // force the destructor to be evaluated
1563
1564     if vs.is_empty() && tcx.has_attr(def_id, "repr") {
1565         struct_span_err!(
1566             tcx.sess, sp, E0084,
1567             "unsupported representation for zero-variant enum")
1568             .span_label(sp, "unsupported enum representation")
1569             .emit();
1570     }
1571
1572     let repr_type_ty = def.repr.discr_type().to_ty(tcx);
1573     if repr_type_ty == tcx.types.i128 || repr_type_ty == tcx.types.u128 {
1574         if !tcx.sess.features.borrow().repr128 {
1575             emit_feature_err(&tcx.sess.parse_sess,
1576                              "repr128",
1577                              sp,
1578                              GateIssue::Language,
1579                              "repr with 128-bit type is unstable");
1580         }
1581     }
1582
1583     for v in vs {
1584         if let Some(e) = v.node.disr_expr {
1585             tcx.typeck_tables_of(tcx.hir.local_def_id(e.node_id));
1586         }
1587     }
1588
1589     let mut disr_vals: Vec<ConstInt> = Vec::new();
1590     for (discr, v) in def.discriminants(tcx).zip(vs) {
1591         // Check for duplicate discriminant values
1592         if let Some(i) = disr_vals.iter().position(|&x| x == discr) {
1593             let variant_i_node_id = tcx.hir.as_local_node_id(def.variants[i].did).unwrap();
1594             let variant_i = tcx.hir.expect_variant(variant_i_node_id);
1595             let i_span = match variant_i.node.disr_expr {
1596                 Some(expr) => tcx.hir.span(expr.node_id),
1597                 None => tcx.hir.span(variant_i_node_id)
1598             };
1599             let span = match v.node.disr_expr {
1600                 Some(expr) => tcx.hir.span(expr.node_id),
1601                 None => v.span
1602             };
1603             struct_span_err!(tcx.sess, span, E0081,
1604                              "discriminant value `{}` already exists", disr_vals[i])
1605                 .span_label(i_span, format!("first use of `{}`", disr_vals[i]))
1606                 .span_label(span , format!("enum already has `{}`", disr_vals[i]))
1607                 .emit();
1608         }
1609         disr_vals.push(discr);
1610     }
1611
1612     check_representable(tcx, sp, def_id);
1613 }
1614
1615 impl<'a, 'gcx, 'tcx> AstConv<'gcx, 'tcx> for FnCtxt<'a, 'gcx, 'tcx> {
1616     fn tcx<'b>(&'b self) -> TyCtxt<'b, 'gcx, 'tcx> { self.tcx }
1617
1618     fn get_type_parameter_bounds(&self, _: Span, def_id: DefId)
1619                                  -> ty::GenericPredicates<'tcx>
1620     {
1621         let tcx = self.tcx;
1622         let node_id = tcx.hir.as_local_node_id(def_id).unwrap();
1623         let item_id = tcx.hir.ty_param_owner(node_id);
1624         let item_def_id = tcx.hir.local_def_id(item_id);
1625         let generics = tcx.generics_of(item_def_id);
1626         let index = generics.type_param_to_index[&def_id.index];
1627         ty::GenericPredicates {
1628             parent: None,
1629             predicates: self.param_env.caller_bounds.iter().filter(|predicate| {
1630                 match **predicate {
1631                     ty::Predicate::Trait(ref data) => {
1632                         data.0.self_ty().is_param(index)
1633                     }
1634                     _ => false
1635                 }
1636             }).cloned().collect()
1637         }
1638     }
1639
1640     fn re_infer(&self, span: Span, def: Option<&ty::RegionParameterDef>)
1641                 -> Option<ty::Region<'tcx>> {
1642         let v = match def {
1643             Some(def) => infer::EarlyBoundRegion(span, def.name),
1644             None => infer::MiscVariable(span)
1645         };
1646         Some(self.next_region_var(v))
1647     }
1648
1649     fn ty_infer(&self, span: Span) -> Ty<'tcx> {
1650         self.next_ty_var(TypeVariableOrigin::TypeInference(span))
1651     }
1652
1653     fn ty_infer_for_def(&self,
1654                         ty_param_def: &ty::TypeParameterDef,
1655                         substs: &[Kind<'tcx>],
1656                         span: Span) -> Ty<'tcx> {
1657         self.type_var_for_def(span, ty_param_def, substs)
1658     }
1659
1660     fn projected_ty_from_poly_trait_ref(&self,
1661                                         span: Span,
1662                                         item_def_id: DefId,
1663                                         poly_trait_ref: ty::PolyTraitRef<'tcx>)
1664                                         -> Ty<'tcx>
1665     {
1666         let (trait_ref, _) =
1667             self.replace_late_bound_regions_with_fresh_var(
1668                 span,
1669                 infer::LateBoundRegionConversionTime::AssocTypeProjection(item_def_id),
1670                 &poly_trait_ref);
1671
1672         self.tcx().mk_projection(item_def_id, trait_ref.substs)
1673     }
1674
1675     fn normalize_ty(&self, span: Span, ty: Ty<'tcx>) -> Ty<'tcx> {
1676         if ty.has_escaping_regions() {
1677             ty // FIXME: normalization and escaping regions
1678         } else {
1679             self.normalize_associated_types_in(span, &ty)
1680         }
1681     }
1682
1683     fn set_tainted_by_errors(&self) {
1684         self.infcx.set_tainted_by_errors()
1685     }
1686
1687     fn record_ty(&self, hir_id: hir::HirId, ty: Ty<'tcx>, _span: Span) {
1688         self.write_ty(hir_id, ty)
1689     }
1690 }
1691
1692 /// Controls whether the arguments are tupled. This is used for the call
1693 /// operator.
1694 ///
1695 /// Tupling means that all call-side arguments are packed into a tuple and
1696 /// passed as a single parameter. For example, if tupling is enabled, this
1697 /// function:
1698 ///
1699 ///     fn f(x: (isize, isize))
1700 ///
1701 /// Can be called as:
1702 ///
1703 ///     f(1, 2);
1704 ///
1705 /// Instead of:
1706 ///
1707 ///     f((1, 2));
1708 #[derive(Clone, Eq, PartialEq)]
1709 enum TupleArgumentsFlag {
1710     DontTupleArguments,
1711     TupleArguments,
1712 }
1713
1714 impl<'a, 'gcx, 'tcx> FnCtxt<'a, 'gcx, 'tcx> {
1715     pub fn new(inh: &'a Inherited<'a, 'gcx, 'tcx>,
1716                param_env: ty::ParamEnv<'tcx>,
1717                body_id: ast::NodeId)
1718                -> FnCtxt<'a, 'gcx, 'tcx> {
1719         FnCtxt {
1720             body_id,
1721             param_env,
1722             err_count_on_creation: inh.tcx.sess.err_count(),
1723             ret_coercion: None,
1724             yield_ty: None,
1725             ps: RefCell::new(UnsafetyState::function(hir::Unsafety::Normal,
1726                                                      ast::CRATE_NODE_ID)),
1727             diverges: Cell::new(Diverges::Maybe),
1728             has_errors: Cell::new(false),
1729             enclosing_breakables: RefCell::new(EnclosingBreakables {
1730                 stack: Vec::new(),
1731                 by_id: NodeMap(),
1732             }),
1733             inh,
1734         }
1735     }
1736
1737     pub fn sess(&self) -> &Session {
1738         &self.tcx.sess
1739     }
1740
1741     pub fn err_count_since_creation(&self) -> usize {
1742         self.tcx.sess.err_count() - self.err_count_on_creation
1743     }
1744
1745     /// Produce warning on the given node, if the current point in the
1746     /// function is unreachable, and there hasn't been another warning.
1747     fn warn_if_unreachable(&self, id: ast::NodeId, span: Span, kind: &str) {
1748         if self.diverges.get() == Diverges::Always {
1749             self.diverges.set(Diverges::WarnedAlways);
1750
1751             debug!("warn_if_unreachable: id={:?} span={:?} kind={}", id, span, kind);
1752
1753             self.tcx().lint_node(
1754                 lint::builtin::UNREACHABLE_CODE,
1755                 id, span,
1756                 &format!("unreachable {}", kind));
1757         }
1758     }
1759
1760     pub fn cause(&self,
1761                  span: Span,
1762                  code: ObligationCauseCode<'tcx>)
1763                  -> ObligationCause<'tcx> {
1764         ObligationCause::new(span, self.body_id, code)
1765     }
1766
1767     pub fn misc(&self, span: Span) -> ObligationCause<'tcx> {
1768         self.cause(span, ObligationCauseCode::MiscObligation)
1769     }
1770
1771     /// Resolves type variables in `ty` if possible. Unlike the infcx
1772     /// version (resolve_type_vars_if_possible), this version will
1773     /// also select obligations if it seems useful, in an effort
1774     /// to get more type information.
1775     fn resolve_type_vars_with_obligations(&self, mut ty: Ty<'tcx>) -> Ty<'tcx> {
1776         debug!("resolve_type_vars_with_obligations(ty={:?})", ty);
1777
1778         // No TyInfer()? Nothing needs doing.
1779         if !ty.has_infer_types() {
1780             debug!("resolve_type_vars_with_obligations: ty={:?}", ty);
1781             return ty;
1782         }
1783
1784         // If `ty` is a type variable, see whether we already know what it is.
1785         ty = self.resolve_type_vars_if_possible(&ty);
1786         if !ty.has_infer_types() {
1787             debug!("resolve_type_vars_with_obligations: ty={:?}", ty);
1788             return ty;
1789         }
1790
1791         // If not, try resolving pending obligations as much as
1792         // possible. This can help substantially when there are
1793         // indirect dependencies that don't seem worth tracking
1794         // precisely.
1795         self.select_obligations_where_possible();
1796         ty = self.resolve_type_vars_if_possible(&ty);
1797
1798         debug!("resolve_type_vars_with_obligations: ty={:?}", ty);
1799         ty
1800     }
1801
1802     fn record_deferred_call_resolution(&self,
1803                                        closure_def_id: DefId,
1804                                        r: DeferredCallResolution<'gcx, 'tcx>) {
1805         let mut deferred_call_resolutions = self.deferred_call_resolutions.borrow_mut();
1806         deferred_call_resolutions.entry(closure_def_id).or_insert(vec![]).push(r);
1807     }
1808
1809     fn remove_deferred_call_resolutions(&self,
1810                                         closure_def_id: DefId)
1811                                         -> Vec<DeferredCallResolution<'gcx, 'tcx>>
1812     {
1813         let mut deferred_call_resolutions = self.deferred_call_resolutions.borrow_mut();
1814         deferred_call_resolutions.remove(&closure_def_id).unwrap_or(vec![])
1815     }
1816
1817     pub fn tag(&self) -> String {
1818         let self_ptr: *const FnCtxt = self;
1819         format!("{:?}", self_ptr)
1820     }
1821
1822     pub fn local_ty(&self, span: Span, nid: ast::NodeId) -> Ty<'tcx> {
1823         match self.locals.borrow().get(&nid) {
1824             Some(&t) => t,
1825             None => {
1826                 span_bug!(span, "no type for local variable {}",
1827                           self.tcx.hir.node_to_string(nid));
1828             }
1829         }
1830     }
1831
1832     #[inline]
1833     pub fn write_ty(&self, id: hir::HirId, ty: Ty<'tcx>) {
1834         debug!("write_ty({:?}, {:?}) in fcx {}",
1835                id, self.resolve_type_vars_if_possible(&ty), self.tag());
1836         self.tables.borrow_mut().node_types_mut().insert(id, ty);
1837
1838         if ty.references_error() {
1839             self.has_errors.set(true);
1840             self.set_tainted_by_errors();
1841         }
1842     }
1843
1844     // The NodeId and the ItemLocalId must identify the same item. We just pass
1845     // both of them for consistency checking.
1846     pub fn write_method_call(&self,
1847                              hir_id: hir::HirId,
1848                              method: MethodCallee<'tcx>) {
1849         self.tables
1850             .borrow_mut()
1851             .type_dependent_defs_mut()
1852             .insert(hir_id, Def::Method(method.def_id));
1853         self.write_substs(hir_id, method.substs);
1854     }
1855
1856     pub fn write_substs(&self, node_id: hir::HirId, substs: &'tcx Substs<'tcx>) {
1857         if !substs.is_noop() {
1858             debug!("write_substs({:?}, {:?}) in fcx {}",
1859                    node_id,
1860                    substs,
1861                    self.tag());
1862
1863             self.tables.borrow_mut().node_substs_mut().insert(node_id, substs);
1864         }
1865     }
1866
1867     pub fn apply_adjustments(&self, expr: &hir::Expr, adj: Vec<Adjustment<'tcx>>) {
1868         debug!("apply_adjustments(expr={:?}, adj={:?})", expr, adj);
1869
1870         if adj.is_empty() {
1871             return;
1872         }
1873
1874         match self.tables.borrow_mut().adjustments_mut().entry(expr.hir_id) {
1875             Entry::Vacant(entry) => { entry.insert(adj); },
1876             Entry::Occupied(mut entry) => {
1877                 debug!(" - composing on top of {:?}", entry.get());
1878                 match (&entry.get()[..], &adj[..]) {
1879                     // Applying any adjustment on top of a NeverToAny
1880                     // is a valid NeverToAny adjustment, because it can't
1881                     // be reached.
1882                     (&[Adjustment { kind: Adjust::NeverToAny, .. }], _) => return,
1883                     (&[
1884                         Adjustment { kind: Adjust::Deref(_), .. },
1885                         Adjustment { kind: Adjust::Borrow(AutoBorrow::Ref(..)), .. },
1886                     ], &[
1887                         Adjustment { kind: Adjust::Deref(_), .. },
1888                         .. // Any following adjustments are allowed.
1889                     ]) => {
1890                         // A reborrow has no effect before a dereference.
1891                     }
1892                     // FIXME: currently we never try to compose autoderefs
1893                     // and ReifyFnPointer/UnsafeFnPointer, but we could.
1894                     _ =>
1895                         bug!("while adjusting {:?}, can't compose {:?} and {:?}",
1896                              expr, entry.get(), adj)
1897                 };
1898                 *entry.get_mut() = adj;
1899             }
1900         }
1901     }
1902
1903     /// Basically whenever we are converting from a type scheme into
1904     /// the fn body space, we always want to normalize associated
1905     /// types as well. This function combines the two.
1906     fn instantiate_type_scheme<T>(&self,
1907                                   span: Span,
1908                                   substs: &Substs<'tcx>,
1909                                   value: &T)
1910                                   -> T
1911         where T : TypeFoldable<'tcx>
1912     {
1913         let value = value.subst(self.tcx, substs);
1914         let result = self.normalize_associated_types_in(span, &value);
1915         debug!("instantiate_type_scheme(value={:?}, substs={:?}) = {:?}",
1916                value,
1917                substs,
1918                result);
1919         result
1920     }
1921
1922     /// As `instantiate_type_scheme`, but for the bounds found in a
1923     /// generic type scheme.
1924     fn instantiate_bounds(&self, span: Span, def_id: DefId, substs: &Substs<'tcx>)
1925                           -> ty::InstantiatedPredicates<'tcx> {
1926         let bounds = self.tcx.predicates_of(def_id);
1927         let result = bounds.instantiate(self.tcx, substs);
1928         let result = self.normalize_associated_types_in(span, &result);
1929         debug!("instantiate_bounds(bounds={:?}, substs={:?}) = {:?}",
1930                bounds,
1931                substs,
1932                result);
1933         result
1934     }
1935
1936     /// Replace all anonymized types with fresh inference variables
1937     /// and record them for writeback.
1938     fn instantiate_anon_types<T: TypeFoldable<'tcx>>(&self, value: &T) -> T {
1939         value.fold_with(&mut BottomUpFolder { tcx: self.tcx, fldop: |ty| {
1940             if let ty::TyAnon(def_id, substs) = ty.sty {
1941                 // Use the same type variable if the exact same TyAnon appears more
1942                 // than once in the return type (e.g. if it's passed to a type alias).
1943                 let id = self.tcx.hir.as_local_node_id(def_id).unwrap();
1944                 if let Some(ty_var) = self.anon_types.borrow().get(&id) {
1945                     return ty_var;
1946                 }
1947                 let span = self.tcx.def_span(def_id);
1948                 let ty_var = self.next_ty_var(TypeVariableOrigin::TypeInference(span));
1949                 self.anon_types.borrow_mut().insert(id, ty_var);
1950
1951                 let predicates_of = self.tcx.predicates_of(def_id);
1952                 let bounds = predicates_of.instantiate(self.tcx, substs);
1953
1954                 for predicate in bounds.predicates {
1955                     // Change the predicate to refer to the type variable,
1956                     // which will be the concrete type, instead of the TyAnon.
1957                     // This also instantiates nested `impl Trait`.
1958                     let predicate = self.instantiate_anon_types(&predicate);
1959
1960                     // Require that the predicate holds for the concrete type.
1961                     let cause = traits::ObligationCause::new(span, self.body_id,
1962                                                              traits::SizedReturnType);
1963                     self.register_predicate(traits::Obligation::new(cause,
1964                                                                     self.param_env,
1965                                                                     predicate));
1966                 }
1967
1968                 ty_var
1969             } else {
1970                 ty
1971             }
1972         }})
1973     }
1974
1975     fn normalize_associated_types_in<T>(&self, span: Span, value: &T) -> T
1976         where T : TypeFoldable<'tcx>
1977     {
1978         self.inh.normalize_associated_types_in(span, self.body_id, self.param_env, value)
1979     }
1980
1981     fn normalize_associated_types_in_as_infer_ok<T>(&self, span: Span, value: &T)
1982                                                     -> InferOk<'tcx, T>
1983         where T : TypeFoldable<'tcx>
1984     {
1985         self.inh.normalize_associated_types_in_as_infer_ok(span,
1986                                                            self.body_id,
1987                                                            self.param_env,
1988                                                            value)
1989     }
1990
1991     pub fn require_type_meets(&self,
1992                               ty: Ty<'tcx>,
1993                               span: Span,
1994                               code: traits::ObligationCauseCode<'tcx>,
1995                               def_id: DefId)
1996     {
1997         self.register_bound(
1998             ty,
1999             def_id,
2000             traits::ObligationCause::new(span, self.body_id, code));
2001     }
2002
2003     pub fn require_type_is_sized(&self,
2004                                  ty: Ty<'tcx>,
2005                                  span: Span,
2006                                  code: traits::ObligationCauseCode<'tcx>)
2007     {
2008         let lang_item = self.tcx.require_lang_item(lang_items::SizedTraitLangItem);
2009         self.require_type_meets(ty, span, code, lang_item);
2010     }
2011
2012     pub fn register_bound(&self,
2013                           ty: Ty<'tcx>,
2014                           def_id: DefId,
2015                           cause: traits::ObligationCause<'tcx>)
2016     {
2017         self.fulfillment_cx.borrow_mut()
2018                            .register_bound(self, self.param_env, ty, def_id, cause);
2019     }
2020
2021     pub fn to_ty(&self, ast_t: &hir::Ty) -> Ty<'tcx> {
2022         let t = AstConv::ast_ty_to_ty(self, ast_t);
2023         self.register_wf_obligation(t, ast_t.span, traits::MiscObligation);
2024         t
2025     }
2026
2027     pub fn node_ty(&self, id: hir::HirId) -> Ty<'tcx> {
2028         match self.tables.borrow().node_types().get(id) {
2029             Some(&t) => t,
2030             None if self.is_tainted_by_errors() => self.tcx.types.err,
2031             None => {
2032                 let node_id = self.tcx.hir.definitions().find_node_for_hir_id(id);
2033                 bug!("no type for node {}: {} in fcx {}",
2034                      node_id, self.tcx.hir.node_to_string(node_id),
2035                      self.tag());
2036             }
2037         }
2038     }
2039
2040     /// Registers an obligation for checking later, during regionck, that the type `ty` must
2041     /// outlive the region `r`.
2042     pub fn register_wf_obligation(&self,
2043                                   ty: Ty<'tcx>,
2044                                   span: Span,
2045                                   code: traits::ObligationCauseCode<'tcx>)
2046     {
2047         // WF obligations never themselves fail, so no real need to give a detailed cause:
2048         let cause = traits::ObligationCause::new(span, self.body_id, code);
2049         self.register_predicate(traits::Obligation::new(cause,
2050                                                         self.param_env,
2051                                                         ty::Predicate::WellFormed(ty)));
2052     }
2053
2054     /// Registers obligations that all types appearing in `substs` are well-formed.
2055     pub fn add_wf_bounds(&self, substs: &Substs<'tcx>, expr: &hir::Expr)
2056     {
2057         for ty in substs.types() {
2058             self.register_wf_obligation(ty, expr.span, traits::MiscObligation);
2059         }
2060     }
2061
2062     /// Given a fully substituted set of bounds (`generic_bounds`), and the values with which each
2063     /// type/region parameter was instantiated (`substs`), creates and registers suitable
2064     /// trait/region obligations.
2065     ///
2066     /// For example, if there is a function:
2067     ///
2068     /// ```
2069     /// fn foo<'a,T:'a>(...)
2070     /// ```
2071     ///
2072     /// and a reference:
2073     ///
2074     /// ```
2075     /// let f = foo;
2076     /// ```
2077     ///
2078     /// Then we will create a fresh region variable `'$0` and a fresh type variable `$1` for `'a`
2079     /// and `T`. This routine will add a region obligation `$1:'$0` and register it locally.
2080     pub fn add_obligations_for_parameters(&self,
2081                                           cause: traits::ObligationCause<'tcx>,
2082                                           predicates: &ty::InstantiatedPredicates<'tcx>)
2083     {
2084         assert!(!predicates.has_escaping_regions());
2085
2086         debug!("add_obligations_for_parameters(predicates={:?})",
2087                predicates);
2088
2089         for obligation in traits::predicates_for_generics(cause, self.param_env, predicates) {
2090             self.register_predicate(obligation);
2091         }
2092     }
2093
2094     // FIXME(arielb1): use this instead of field.ty everywhere
2095     // Only for fields! Returns <none> for methods>
2096     // Indifferent to privacy flags
2097     pub fn field_ty(&self,
2098                     span: Span,
2099                     field: &'tcx ty::FieldDef,
2100                     substs: &Substs<'tcx>)
2101                     -> Ty<'tcx>
2102     {
2103         self.normalize_associated_types_in(span,
2104                                            &field.ty(self.tcx, substs))
2105     }
2106
2107     fn check_casts(&self) {
2108         let mut deferred_cast_checks = self.deferred_cast_checks.borrow_mut();
2109         for cast in deferred_cast_checks.drain(..) {
2110             cast.check(self);
2111         }
2112     }
2113
2114     fn resolve_generator_interiors(&self, def_id: DefId) {
2115         let mut deferred_generator_interiors = self.deferred_generator_interiors.borrow_mut();
2116         for (body_id, witness) in deferred_generator_interiors.drain(..) {
2117             generator_interior::resolve_interior(self, def_id, body_id, witness);
2118         }
2119     }
2120
2121     /// Apply "fallbacks" to some types
2122     /// unconstrained types get replaced with ! or  () (depending on whether
2123     /// feature(never_type) is enabled), unconstrained ints with i32, and
2124     /// unconstrained floats with f64.
2125     fn default_type_parameters(&self) {
2126         use rustc::ty::error::UnconstrainedNumeric::Neither;
2127         use rustc::ty::error::UnconstrainedNumeric::{UnconstrainedInt, UnconstrainedFloat};
2128
2129         // Defaulting inference variables becomes very dubious if we have
2130         // encountered type-checking errors. Therefore, if we think we saw
2131         // some errors in this function, just resolve all uninstanted type
2132         // varibles to TyError.
2133         if self.is_tainted_by_errors() {
2134             for ty in &self.unsolved_variables() {
2135                 if let ty::TyInfer(_) = self.shallow_resolve(ty).sty {
2136                     debug!("default_type_parameters: defaulting `{:?}` to error", ty);
2137                     self.demand_eqtype(syntax_pos::DUMMY_SP, *ty, self.tcx().types.err);
2138                 }
2139             }
2140             return;
2141         }
2142
2143         for ty in &self.unsolved_variables() {
2144             let resolved = self.resolve_type_vars_if_possible(ty);
2145             if self.type_var_diverges(resolved) {
2146                 debug!("default_type_parameters: defaulting `{:?}` to `!` because it diverges",
2147                        resolved);
2148                 self.demand_eqtype(syntax_pos::DUMMY_SP, *ty,
2149                                    self.tcx.mk_diverging_default());
2150             } else {
2151                 match self.type_is_unconstrained_numeric(resolved) {
2152                     UnconstrainedInt => {
2153                         debug!("default_type_parameters: defaulting `{:?}` to `i32`",
2154                                resolved);
2155                         self.demand_eqtype(syntax_pos::DUMMY_SP, *ty, self.tcx.types.i32)
2156                     },
2157                     UnconstrainedFloat => {
2158                         debug!("default_type_parameters: defaulting `{:?}` to `f32`",
2159                                resolved);
2160                         self.demand_eqtype(syntax_pos::DUMMY_SP, *ty, self.tcx.types.f64)
2161                     }
2162                     Neither => { }
2163                 }
2164             }
2165         }
2166     }
2167
2168     // Implements type inference fallback algorithm
2169     fn select_all_obligations_and_apply_defaults(&self) {
2170         self.select_obligations_where_possible();
2171         self.default_type_parameters();
2172         self.select_obligations_where_possible();
2173     }
2174
2175     fn select_all_obligations_or_error(&self) {
2176         debug!("select_all_obligations_or_error");
2177
2178         // upvar inference should have ensured that all deferred call
2179         // resolutions are handled by now.
2180         assert!(self.deferred_call_resolutions.borrow().is_empty());
2181
2182         self.select_all_obligations_and_apply_defaults();
2183
2184         let mut fulfillment_cx = self.fulfillment_cx.borrow_mut();
2185
2186         match fulfillment_cx.select_all_or_error(self) {
2187             Ok(()) => { }
2188             Err(errors) => { self.report_fulfillment_errors(&errors, self.inh.body_id); }
2189         }
2190     }
2191
2192     /// Select as many obligations as we can at present.
2193     fn select_obligations_where_possible(&self) {
2194         match self.fulfillment_cx.borrow_mut().select_where_possible(self) {
2195             Ok(()) => { }
2196             Err(errors) => { self.report_fulfillment_errors(&errors, self.inh.body_id); }
2197         }
2198     }
2199
2200     /// For the overloaded lvalue expressions (`*x`, `x[3]`), the trait
2201     /// returns a type of `&T`, but the actual type we assign to the
2202     /// *expression* is `T`. So this function just peels off the return
2203     /// type by one layer to yield `T`.
2204     fn make_overloaded_lvalue_return_type(&self,
2205                                           method: MethodCallee<'tcx>)
2206                                           -> ty::TypeAndMut<'tcx>
2207     {
2208         // extract method return type, which will be &T;
2209         let ret_ty = method.sig.output();
2210
2211         // method returns &T, but the type as visible to user is T, so deref
2212         ret_ty.builtin_deref(true, NoPreference).unwrap()
2213     }
2214
2215     fn lookup_indexing(&self,
2216                        expr: &hir::Expr,
2217                        base_expr: &'gcx hir::Expr,
2218                        base_ty: Ty<'tcx>,
2219                        idx_ty: Ty<'tcx>,
2220                        lvalue_pref: LvaluePreference)
2221                        -> Option<(/*index type*/ Ty<'tcx>, /*element type*/ Ty<'tcx>)>
2222     {
2223         // FIXME(#18741) -- this is almost but not quite the same as the
2224         // autoderef that normal method probing does. They could likely be
2225         // consolidated.
2226
2227         let mut autoderef = self.autoderef(base_expr.span, base_ty);
2228         let mut result = None;
2229         while result.is_none() && autoderef.next().is_some() {
2230             result = self.try_index_step(expr, base_expr, &autoderef, lvalue_pref, idx_ty);
2231         }
2232         autoderef.finalize();
2233         result
2234     }
2235
2236     /// To type-check `base_expr[index_expr]`, we progressively autoderef
2237     /// (and otherwise adjust) `base_expr`, looking for a type which either
2238     /// supports builtin indexing or overloaded indexing.
2239     /// This loop implements one step in that search; the autoderef loop
2240     /// is implemented by `lookup_indexing`.
2241     fn try_index_step(&self,
2242                       expr: &hir::Expr,
2243                       base_expr: &hir::Expr,
2244                       autoderef: &Autoderef<'a, 'gcx, 'tcx>,
2245                       lvalue_pref: LvaluePreference,
2246                       index_ty: Ty<'tcx>)
2247                       -> Option<(/*index type*/ Ty<'tcx>, /*element type*/ Ty<'tcx>)>
2248     {
2249         let adjusted_ty = autoderef.unambiguous_final_ty();
2250         debug!("try_index_step(expr={:?}, base_expr={:?}, adjusted_ty={:?}, \
2251                                index_ty={:?})",
2252                expr,
2253                base_expr,
2254                adjusted_ty,
2255                index_ty);
2256
2257         // First, try built-in indexing.
2258         match (adjusted_ty.builtin_index(), &index_ty.sty) {
2259             (Some(ty), &ty::TyUint(ast::UintTy::Us)) | (Some(ty), &ty::TyInfer(ty::IntVar(_))) => {
2260                 debug!("try_index_step: success, using built-in indexing");
2261                 let adjustments = autoderef.adjust_steps(lvalue_pref);
2262                 self.apply_adjustments(base_expr, adjustments);
2263                 return Some((self.tcx.types.usize, ty));
2264             }
2265             _ => {}
2266         }
2267
2268         for &unsize in &[false, true] {
2269             let mut self_ty = adjusted_ty;
2270             if unsize {
2271                 // We only unsize arrays here.
2272                 if let ty::TyArray(element_ty, _) = adjusted_ty.sty {
2273                     self_ty = self.tcx.mk_slice(element_ty);
2274                 } else {
2275                     continue;
2276                 }
2277             }
2278
2279             // If some lookup succeeds, write callee into table and extract index/element
2280             // type from the method signature.
2281             // If some lookup succeeded, install method in table
2282             let input_ty = self.next_ty_var(TypeVariableOrigin::AutoDeref(base_expr.span));
2283             let method = self.try_overloaded_lvalue_op(
2284                 expr.span, self_ty, &[input_ty], lvalue_pref, LvalueOp::Index);
2285
2286             let result = method.map(|ok| {
2287                 debug!("try_index_step: success, using overloaded indexing");
2288                 let method = self.register_infer_ok_obligations(ok);
2289
2290                 let mut adjustments = autoderef.adjust_steps(lvalue_pref);
2291                 if let ty::TyRef(region, mt) = method.sig.inputs()[0].sty {
2292                     adjustments.push(Adjustment {
2293                         kind: Adjust::Borrow(AutoBorrow::Ref(region, mt.mutbl)),
2294                         target: self.tcx.mk_ref(region, ty::TypeAndMut {
2295                             mutbl: mt.mutbl,
2296                             ty: adjusted_ty
2297                         })
2298                     });
2299                 }
2300                 if unsize {
2301                     adjustments.push(Adjustment {
2302                         kind: Adjust::Unsize,
2303                         target: method.sig.inputs()[0]
2304                     });
2305                 }
2306                 self.apply_adjustments(base_expr, adjustments);
2307
2308                 self.write_method_call(expr.hir_id, method);
2309                 (input_ty, self.make_overloaded_lvalue_return_type(method).ty)
2310             });
2311             if result.is_some() {
2312                 return result;
2313             }
2314         }
2315
2316         None
2317     }
2318
2319     fn resolve_lvalue_op(&self, op: LvalueOp, is_mut: bool) -> (Option<DefId>, Symbol) {
2320         let (tr, name) = match (op, is_mut) {
2321             (LvalueOp::Deref, false) =>
2322                 (self.tcx.lang_items().deref_trait(), "deref"),
2323             (LvalueOp::Deref, true) =>
2324                 (self.tcx.lang_items().deref_mut_trait(), "deref_mut"),
2325             (LvalueOp::Index, false) =>
2326                 (self.tcx.lang_items().index_trait(), "index"),
2327             (LvalueOp::Index, true) =>
2328                 (self.tcx.lang_items().index_mut_trait(), "index_mut"),
2329         };
2330         (tr, Symbol::intern(name))
2331     }
2332
2333     fn try_overloaded_lvalue_op(&self,
2334                                 span: Span,
2335                                 base_ty: Ty<'tcx>,
2336                                 arg_tys: &[Ty<'tcx>],
2337                                 lvalue_pref: LvaluePreference,
2338                                 op: LvalueOp)
2339                                 -> Option<InferOk<'tcx, MethodCallee<'tcx>>>
2340     {
2341         debug!("try_overloaded_lvalue_op({:?},{:?},{:?},{:?})",
2342                span,
2343                base_ty,
2344                lvalue_pref,
2345                op);
2346
2347         // Try Mut first, if preferred.
2348         let (mut_tr, mut_op) = self.resolve_lvalue_op(op, true);
2349         let method = match (lvalue_pref, mut_tr) {
2350             (PreferMutLvalue, Some(trait_did)) => {
2351                 self.lookup_method_in_trait(span, mut_op, trait_did, base_ty, Some(arg_tys))
2352             }
2353             _ => None,
2354         };
2355
2356         // Otherwise, fall back to the immutable version.
2357         let (imm_tr, imm_op) = self.resolve_lvalue_op(op, false);
2358         let method = match (method, imm_tr) {
2359             (None, Some(trait_did)) => {
2360                 self.lookup_method_in_trait(span, imm_op, trait_did, base_ty, Some(arg_tys))
2361             }
2362             (method, _) => method,
2363         };
2364
2365         method
2366     }
2367
2368     fn check_method_argument_types(&self,
2369                                    sp: Span,
2370                                    expr_sp: Span,
2371                                    method: Result<MethodCallee<'tcx>, ()>,
2372                                    args_no_rcvr: &'gcx [hir::Expr],
2373                                    tuple_arguments: TupleArgumentsFlag,
2374                                    expected: Expectation<'tcx>)
2375                                    -> Ty<'tcx> {
2376         let has_error = match method {
2377             Ok(method) => {
2378                 method.substs.references_error() || method.sig.references_error()
2379             }
2380             Err(_) => true
2381         };
2382         if has_error {
2383             let err_inputs = self.err_args(args_no_rcvr.len());
2384
2385             let err_inputs = match tuple_arguments {
2386                 DontTupleArguments => err_inputs,
2387                 TupleArguments => vec![self.tcx.intern_tup(&err_inputs[..], false)],
2388             };
2389
2390             self.check_argument_types(sp, expr_sp, &err_inputs[..], &[], args_no_rcvr,
2391                                       false, tuple_arguments, None);
2392             return self.tcx.types.err;
2393         }
2394
2395         let method = method.unwrap();
2396         // HACK(eddyb) ignore self in the definition (see above).
2397         let expected_arg_tys = self.expected_inputs_for_expected_output(
2398             sp,
2399             expected,
2400             method.sig.output(),
2401             &method.sig.inputs()[1..]
2402         );
2403         self.check_argument_types(sp, expr_sp, &method.sig.inputs()[1..], &expected_arg_tys[..],
2404                                   args_no_rcvr, method.sig.variadic, tuple_arguments,
2405                                   self.tcx.hir.span_if_local(method.def_id));
2406         method.sig.output()
2407     }
2408
2409     /// Generic function that factors out common logic from function calls,
2410     /// method calls and overloaded operators.
2411     fn check_argument_types(&self,
2412                             sp: Span,
2413                             expr_sp: Span,
2414                             fn_inputs: &[Ty<'tcx>],
2415                             expected_arg_tys: &[Ty<'tcx>],
2416                             args: &'gcx [hir::Expr],
2417                             variadic: bool,
2418                             tuple_arguments: TupleArgumentsFlag,
2419                             def_span: Option<Span>) {
2420         let tcx = self.tcx;
2421
2422         // Grab the argument types, supplying fresh type variables
2423         // if the wrong number of arguments were supplied
2424         let supplied_arg_count = if tuple_arguments == DontTupleArguments {
2425             args.len()
2426         } else {
2427             1
2428         };
2429
2430         // All the input types from the fn signature must outlive the call
2431         // so as to validate implied bounds.
2432         for &fn_input_ty in fn_inputs {
2433             self.register_wf_obligation(fn_input_ty, sp, traits::MiscObligation);
2434         }
2435
2436         let mut expected_arg_tys = expected_arg_tys;
2437         let expected_arg_count = fn_inputs.len();
2438
2439         let sp_args = if args.len() > 0 {
2440             let (first, args) = args.split_at(1);
2441             let mut sp_tmp = first[0].span;
2442             for arg in args {
2443                 let sp_opt = self.sess().codemap().merge_spans(sp_tmp, arg.span);
2444                 if ! sp_opt.is_some() {
2445                     break;
2446                 }
2447                 sp_tmp = sp_opt.unwrap();
2448             };
2449             sp_tmp
2450         } else {
2451             sp
2452         };
2453
2454         fn parameter_count_error<'tcx>(sess: &Session,
2455                                        sp: Span,
2456                                        expr_sp: Span,
2457                                        expected_count: usize,
2458                                        arg_count: usize,
2459                                        error_code: &str,
2460                                        variadic: bool,
2461                                        def_span: Option<Span>,
2462                                        sugg_unit: bool) {
2463             let mut err = sess.struct_span_err_with_code(sp,
2464                 &format!("this function takes {}{} parameter{} but {} parameter{} supplied",
2465                     if variadic {"at least "} else {""},
2466                     expected_count,
2467                     if expected_count == 1 {""} else {"s"},
2468                     arg_count,
2469                     if arg_count == 1 {" was"} else {"s were"}),
2470                 DiagnosticId::Error(error_code.to_owned()));
2471
2472             if let Some(def_s) = def_span {
2473                 err.span_label(def_s, "defined here");
2474             }
2475             if sugg_unit {
2476                 let sugg_span = expr_sp.end_point();
2477                 // remove closing `)` from the span
2478                 let sugg_span = sugg_span.with_hi(sugg_span.lo());
2479                 err.span_suggestion(
2480                     sugg_span,
2481                     "expected the unit value `()`; create it with empty parentheses",
2482                     String::from("()"));
2483             } else {
2484                 err.span_label(sp, format!("expected {}{} parameter{}",
2485                                             if variadic {"at least "} else {""},
2486                                             expected_count,
2487                                             if expected_count == 1 {""} else {"s"}));
2488             }
2489             err.emit();
2490         }
2491
2492         let formal_tys = if tuple_arguments == TupleArguments {
2493             let tuple_type = self.structurally_resolved_type(sp, fn_inputs[0]);
2494             match tuple_type.sty {
2495                 ty::TyTuple(arg_types, _) if arg_types.len() != args.len() => {
2496                     parameter_count_error(tcx.sess, sp_args, expr_sp, arg_types.len(), args.len(),
2497                                           "E0057", false, def_span, false);
2498                     expected_arg_tys = &[];
2499                     self.err_args(args.len())
2500                 }
2501                 ty::TyTuple(arg_types, _) => {
2502                     expected_arg_tys = match expected_arg_tys.get(0) {
2503                         Some(&ty) => match ty.sty {
2504                             ty::TyTuple(ref tys, _) => &tys,
2505                             _ => &[]
2506                         },
2507                         None => &[]
2508                     };
2509                     arg_types.to_vec()
2510                 }
2511                 _ => {
2512                     span_err!(tcx.sess, sp, E0059,
2513                         "cannot use call notation; the first type parameter \
2514                          for the function trait is neither a tuple nor unit");
2515                     expected_arg_tys = &[];
2516                     self.err_args(args.len())
2517                 }
2518             }
2519         } else if expected_arg_count == supplied_arg_count {
2520             fn_inputs.to_vec()
2521         } else if variadic {
2522             if supplied_arg_count >= expected_arg_count {
2523                 fn_inputs.to_vec()
2524             } else {
2525                 parameter_count_error(tcx.sess, sp_args, expr_sp, expected_arg_count,
2526                                       supplied_arg_count, "E0060", true, def_span, false);
2527                 expected_arg_tys = &[];
2528                 self.err_args(supplied_arg_count)
2529             }
2530         } else {
2531             // is the missing argument of type `()`?
2532             let sugg_unit = if expected_arg_tys.len() == 1 && supplied_arg_count == 0 {
2533                 self.resolve_type_vars_if_possible(&expected_arg_tys[0]).is_nil()
2534             } else if fn_inputs.len() == 1 && supplied_arg_count == 0 {
2535                 self.resolve_type_vars_if_possible(&fn_inputs[0]).is_nil()
2536             } else {
2537                 false
2538             };
2539             parameter_count_error(tcx.sess, sp_args, expr_sp, expected_arg_count,
2540                                   supplied_arg_count, "E0061", false, def_span, sugg_unit);
2541             expected_arg_tys = &[];
2542             self.err_args(supplied_arg_count)
2543         };
2544
2545         debug!("check_argument_types: formal_tys={:?}",
2546                formal_tys.iter().map(|t| self.ty_to_string(*t)).collect::<Vec<String>>());
2547
2548         // Check the arguments.
2549         // We do this in a pretty awful way: first we typecheck any arguments
2550         // that are not closures, then we typecheck the closures. This is so
2551         // that we have more information about the types of arguments when we
2552         // typecheck the functions. This isn't really the right way to do this.
2553         for &check_closures in &[false, true] {
2554             debug!("check_closures={}", check_closures);
2555
2556             // More awful hacks: before we check argument types, try to do
2557             // an "opportunistic" vtable resolution of any trait bounds on
2558             // the call. This helps coercions.
2559             if check_closures {
2560                 self.select_obligations_where_possible();
2561             }
2562
2563             // For variadic functions, we don't have a declared type for all of
2564             // the arguments hence we only do our usual type checking with
2565             // the arguments who's types we do know.
2566             let t = if variadic {
2567                 expected_arg_count
2568             } else if tuple_arguments == TupleArguments {
2569                 args.len()
2570             } else {
2571                 supplied_arg_count
2572             };
2573             for (i, arg) in args.iter().take(t).enumerate() {
2574                 // Warn only for the first loop (the "no closures" one).
2575                 // Closure arguments themselves can't be diverging, but
2576                 // a previous argument can, e.g. `foo(panic!(), || {})`.
2577                 if !check_closures {
2578                     self.warn_if_unreachable(arg.id, arg.span, "expression");
2579                 }
2580
2581                 let is_closure = match arg.node {
2582                     hir::ExprClosure(..) => true,
2583                     _ => false
2584                 };
2585
2586                 if is_closure != check_closures {
2587                     continue;
2588                 }
2589
2590                 debug!("checking the argument");
2591                 let formal_ty = formal_tys[i];
2592
2593                 // The special-cased logic below has three functions:
2594                 // 1. Provide as good of an expected type as possible.
2595                 let expected = expected_arg_tys.get(i).map(|&ty| {
2596                     Expectation::rvalue_hint(self, ty)
2597                 });
2598
2599                 let checked_ty = self.check_expr_with_expectation(
2600                     &arg,
2601                     expected.unwrap_or(ExpectHasType(formal_ty)));
2602
2603                 // 2. Coerce to the most detailed type that could be coerced
2604                 //    to, which is `expected_ty` if `rvalue_hint` returns an
2605                 //    `ExpectHasType(expected_ty)`, or the `formal_ty` otherwise.
2606                 let coerce_ty = expected.and_then(|e| e.only_has_type(self));
2607                 self.demand_coerce(&arg, checked_ty, coerce_ty.unwrap_or(formal_ty));
2608
2609                 // 3. Relate the expected type and the formal one,
2610                 //    if the expected type was used for the coercion.
2611                 coerce_ty.map(|ty| self.demand_suptype(arg.span, formal_ty, ty));
2612             }
2613         }
2614
2615         // We also need to make sure we at least write the ty of the other
2616         // arguments which we skipped above.
2617         if variadic {
2618             fn variadic_error<'tcx>(s: &Session, span: Span, t: Ty<'tcx>, cast_ty: &str) {
2619                 type_error_struct!(s, span, t, E0617,
2620                                    "can't pass `{}` to variadic function, cast to `{}`",
2621                                    t, cast_ty).emit();
2622             }
2623
2624             for arg in args.iter().skip(expected_arg_count) {
2625                 let arg_ty = self.check_expr(&arg);
2626
2627                 // There are a few types which get autopromoted when passed via varargs
2628                 // in C but we just error out instead and require explicit casts.
2629                 let arg_ty = self.structurally_resolved_type(arg.span, arg_ty);
2630                 match arg_ty.sty {
2631                     ty::TyFloat(ast::FloatTy::F32) => {
2632                         variadic_error(tcx.sess, arg.span, arg_ty, "c_double");
2633                     }
2634                     ty::TyInt(ast::IntTy::I8) | ty::TyInt(ast::IntTy::I16) | ty::TyBool => {
2635                         variadic_error(tcx.sess, arg.span, arg_ty, "c_int");
2636                     }
2637                     ty::TyUint(ast::UintTy::U8) | ty::TyUint(ast::UintTy::U16) => {
2638                         variadic_error(tcx.sess, arg.span, arg_ty, "c_uint");
2639                     }
2640                     ty::TyFnDef(..) => {
2641                         let ptr_ty = self.tcx.mk_fn_ptr(arg_ty.fn_sig(self.tcx));
2642                         let ptr_ty = self.resolve_type_vars_if_possible(&ptr_ty);
2643                         variadic_error(tcx.sess, arg.span, arg_ty, &format!("{}", ptr_ty));
2644                     }
2645                     _ => {}
2646                 }
2647             }
2648         }
2649     }
2650
2651     fn err_args(&self, len: usize) -> Vec<Ty<'tcx>> {
2652         (0..len).map(|_| self.tcx.types.err).collect()
2653     }
2654
2655     // AST fragment checking
2656     fn check_lit(&self,
2657                  lit: &ast::Lit,
2658                  expected: Expectation<'tcx>)
2659                  -> Ty<'tcx>
2660     {
2661         let tcx = self.tcx;
2662
2663         match lit.node {
2664             ast::LitKind::Str(..) => tcx.mk_static_str(),
2665             ast::LitKind::ByteStr(ref v) => {
2666                 tcx.mk_imm_ref(tcx.types.re_static,
2667                                 tcx.mk_array(tcx.types.u8, v.len() as u64))
2668             }
2669             ast::LitKind::Byte(_) => tcx.types.u8,
2670             ast::LitKind::Char(_) => tcx.types.char,
2671             ast::LitKind::Int(_, ast::LitIntType::Signed(t)) => tcx.mk_mach_int(t),
2672             ast::LitKind::Int(_, ast::LitIntType::Unsigned(t)) => tcx.mk_mach_uint(t),
2673             ast::LitKind::Int(_, ast::LitIntType::Unsuffixed) => {
2674                 let opt_ty = expected.to_option(self).and_then(|ty| {
2675                     match ty.sty {
2676                         ty::TyInt(_) | ty::TyUint(_) => Some(ty),
2677                         ty::TyChar => Some(tcx.types.u8),
2678                         ty::TyRawPtr(..) => Some(tcx.types.usize),
2679                         ty::TyFnDef(..) | ty::TyFnPtr(_) => Some(tcx.types.usize),
2680                         _ => None
2681                     }
2682                 });
2683                 opt_ty.unwrap_or_else(
2684                     || tcx.mk_int_var(self.next_int_var_id()))
2685             }
2686             ast::LitKind::Float(_, t) => tcx.mk_mach_float(t),
2687             ast::LitKind::FloatUnsuffixed(_) => {
2688                 let opt_ty = expected.to_option(self).and_then(|ty| {
2689                     match ty.sty {
2690                         ty::TyFloat(_) => Some(ty),
2691                         _ => None
2692                     }
2693                 });
2694                 opt_ty.unwrap_or_else(
2695                     || tcx.mk_float_var(self.next_float_var_id()))
2696             }
2697             ast::LitKind::Bool(_) => tcx.types.bool
2698         }
2699     }
2700
2701     fn check_expr_eq_type(&self,
2702                           expr: &'gcx hir::Expr,
2703                           expected: Ty<'tcx>) {
2704         let ty = self.check_expr_with_hint(expr, expected);
2705         self.demand_eqtype(expr.span, expected, ty);
2706     }
2707
2708     pub fn check_expr_has_type_or_error(&self,
2709                                         expr: &'gcx hir::Expr,
2710                                         expected: Ty<'tcx>) -> Ty<'tcx> {
2711         self.check_expr_meets_expectation_or_error(expr, ExpectHasType(expected))
2712     }
2713
2714     fn check_expr_meets_expectation_or_error(&self,
2715                                              expr: &'gcx hir::Expr,
2716                                              expected: Expectation<'tcx>) -> Ty<'tcx> {
2717         let expected_ty = expected.to_option(&self).unwrap_or(self.tcx.types.bool);
2718         let mut ty = self.check_expr_with_expectation(expr, expected);
2719
2720         // While we don't allow *arbitrary* coercions here, we *do* allow
2721         // coercions from ! to `expected`.
2722         if ty.is_never() {
2723             assert!(!self.tables.borrow().adjustments().contains_key(expr.hir_id),
2724                     "expression with never type wound up being adjusted");
2725             let adj_ty = self.next_diverging_ty_var(
2726                 TypeVariableOrigin::AdjustmentType(expr.span));
2727             self.apply_adjustments(expr, vec![Adjustment {
2728                 kind: Adjust::NeverToAny,
2729                 target: adj_ty
2730             }]);
2731             ty = adj_ty;
2732         }
2733
2734         if let Some(mut err) = self.demand_suptype_diag(expr.span, expected_ty, ty) {
2735             // Add help to type error if this is an `if` condition with an assignment
2736             match (expected, &expr.node) {
2737                 (ExpectIfCondition, &hir::ExprAssign(ref lhs, ref rhs)) => {
2738                     let msg = "try comparing for equality";
2739                     if let (Ok(left), Ok(right)) = (
2740                         self.tcx.sess.codemap().span_to_snippet(lhs.span),
2741                         self.tcx.sess.codemap().span_to_snippet(rhs.span))
2742                     {
2743                         err.span_suggestion(expr.span, msg, format!("{} == {}", left, right));
2744                     } else {
2745                         err.help(msg);
2746                     }
2747                 }
2748                 _ => (),
2749             }
2750             err.emit();
2751         }
2752         ty
2753     }
2754
2755     fn check_expr_coercable_to_type(&self,
2756                                     expr: &'gcx hir::Expr,
2757                                     expected: Ty<'tcx>) -> Ty<'tcx> {
2758         self.check_expr_coercable_to_type_with_lvalue_pref(expr, expected, NoPreference)
2759     }
2760
2761     fn check_expr_coercable_to_type_with_lvalue_pref(&self,
2762                                                      expr: &'gcx hir::Expr,
2763                                                      expected: Ty<'tcx>,
2764                                                      lvalue_pref: LvaluePreference)
2765                                                      -> Ty<'tcx> {
2766         let ty = self.check_expr_with_expectation_and_lvalue_pref(
2767             expr,
2768             ExpectHasType(expected),
2769             lvalue_pref);
2770         self.demand_coerce(expr, ty, expected)
2771     }
2772
2773     fn check_expr_with_hint(&self, expr: &'gcx hir::Expr,
2774                             expected: Ty<'tcx>) -> Ty<'tcx> {
2775         self.check_expr_with_expectation(expr, ExpectHasType(expected))
2776     }
2777
2778     fn check_expr_with_expectation(&self,
2779                                    expr: &'gcx hir::Expr,
2780                                    expected: Expectation<'tcx>) -> Ty<'tcx> {
2781         self.check_expr_with_expectation_and_lvalue_pref(expr, expected, NoPreference)
2782     }
2783
2784     fn check_expr(&self, expr: &'gcx hir::Expr) -> Ty<'tcx> {
2785         self.check_expr_with_expectation(expr, NoExpectation)
2786     }
2787
2788     fn check_expr_with_lvalue_pref(&self, expr: &'gcx hir::Expr,
2789                                    lvalue_pref: LvaluePreference) -> Ty<'tcx> {
2790         self.check_expr_with_expectation_and_lvalue_pref(expr, NoExpectation, lvalue_pref)
2791     }
2792
2793     // determine the `self` type, using fresh variables for all variables
2794     // declared on the impl declaration e.g., `impl<A,B> for Vec<(A,B)>`
2795     // would return ($0, $1) where $0 and $1 are freshly instantiated type
2796     // variables.
2797     pub fn impl_self_ty(&self,
2798                         span: Span, // (potential) receiver for this impl
2799                         did: DefId)
2800                         -> TypeAndSubsts<'tcx> {
2801         let ity = self.tcx.type_of(did);
2802         debug!("impl_self_ty: ity={:?}", ity);
2803
2804         let substs = self.fresh_substs_for_item(span, did);
2805         let substd_ty = self.instantiate_type_scheme(span, &substs, &ity);
2806
2807         TypeAndSubsts { substs: substs, ty: substd_ty }
2808     }
2809
2810     /// Unifies the output type with the expected type early, for more coercions
2811     /// and forward type information on the input expressions.
2812     fn expected_inputs_for_expected_output(&self,
2813                                            call_span: Span,
2814                                            expected_ret: Expectation<'tcx>,
2815                                            formal_ret: Ty<'tcx>,
2816                                            formal_args: &[Ty<'tcx>])
2817                                            -> Vec<Ty<'tcx>> {
2818         let formal_ret = self.resolve_type_vars_with_obligations(formal_ret);
2819         let expected_args = expected_ret.only_has_type(self).and_then(|ret_ty| {
2820             self.fudge_regions_if_ok(&RegionVariableOrigin::Coercion(call_span), || {
2821                 // Attempt to apply a subtyping relationship between the formal
2822                 // return type (likely containing type variables if the function
2823                 // is polymorphic) and the expected return type.
2824                 // No argument expectations are produced if unification fails.
2825                 let origin = self.misc(call_span);
2826                 let ures = self.at(&origin, self.param_env).sup(ret_ty, formal_ret);
2827
2828                 // FIXME(#15760) can't use try! here, FromError doesn't default
2829                 // to identity so the resulting type is not constrained.
2830                 match ures {
2831                     Ok(ok) => {
2832                         // Process any obligations locally as much as
2833                         // we can.  We don't care if some things turn
2834                         // out unconstrained or ambiguous, as we're
2835                         // just trying to get hints here.
2836                         let result = self.save_and_restore_in_snapshot_flag(|_| {
2837                             let mut fulfill = FulfillmentContext::new();
2838                             let ok = ok; // FIXME(#30046)
2839                             for obligation in ok.obligations {
2840                                 fulfill.register_predicate_obligation(self, obligation);
2841                             }
2842                             fulfill.select_where_possible(self)
2843                         });
2844
2845                         match result {
2846                             Ok(()) => { }
2847                             Err(_) => return Err(()),
2848                         }
2849                     }
2850                     Err(_) => return Err(()),
2851                 }
2852
2853                 // Record all the argument types, with the substitutions
2854                 // produced from the above subtyping unification.
2855                 Ok(formal_args.iter().map(|ty| {
2856                     self.resolve_type_vars_if_possible(ty)
2857                 }).collect())
2858             }).ok()
2859         }).unwrap_or(vec![]);
2860         debug!("expected_inputs_for_expected_output(formal={:?} -> {:?}, expected={:?} -> {:?})",
2861                formal_args, formal_ret,
2862                expected_args, expected_ret);
2863         expected_args
2864     }
2865
2866     // Checks a method call.
2867     fn check_method_call(&self,
2868                          expr: &'gcx hir::Expr,
2869                          segment: &hir::PathSegment,
2870                          span: Span,
2871                          args: &'gcx [hir::Expr],
2872                          expected: Expectation<'tcx>,
2873                          lvalue_pref: LvaluePreference) -> Ty<'tcx> {
2874         let rcvr = &args[0];
2875         let rcvr_t = self.check_expr_with_lvalue_pref(&rcvr, lvalue_pref);
2876         // no need to check for bot/err -- callee does that
2877         let rcvr_t = self.structurally_resolved_type(expr.span, rcvr_t);
2878
2879         let method = match self.lookup_method(rcvr_t,
2880                                               segment,
2881                                               span,
2882                                               expr,
2883                                               rcvr) {
2884             Ok(method) => {
2885                 self.write_method_call(expr.hir_id, method);
2886                 Ok(method)
2887             }
2888             Err(error) => {
2889                 if segment.name != keywords::Invalid.name() {
2890                     self.report_method_error(span,
2891                                              rcvr_t,
2892                                              segment.name,
2893                                              Some(rcvr),
2894                                              error,
2895                                              Some(args));
2896                 }
2897                 Err(())
2898             }
2899         };
2900
2901         // Call the generic checker.
2902         self.check_method_argument_types(span,
2903                                          expr.span,
2904                                          method,
2905                                          &args[1..],
2906                                          DontTupleArguments,
2907                                          expected)
2908     }
2909
2910     fn check_return_expr(&self, return_expr: &'gcx hir::Expr) {
2911         let ret_coercion =
2912             self.ret_coercion
2913                 .as_ref()
2914                 .unwrap_or_else(|| span_bug!(return_expr.span,
2915                                              "check_return_expr called outside fn body"));
2916
2917         let ret_ty = ret_coercion.borrow().expected_ty();
2918         let return_expr_ty = self.check_expr_with_hint(return_expr, ret_ty.clone());
2919         ret_coercion.borrow_mut()
2920                     .coerce(self,
2921                             &self.cause(return_expr.span,
2922                                         ObligationCauseCode::ReturnType(return_expr.id)),
2923                             return_expr,
2924                             return_expr_ty,
2925                             self.diverges.get());
2926     }
2927
2928
2929     // A generic function for checking the then and else in an if
2930     // or if-else.
2931     fn check_then_else(&self,
2932                        cond_expr: &'gcx hir::Expr,
2933                        then_expr: &'gcx hir::Expr,
2934                        opt_else_expr: Option<&'gcx hir::Expr>,
2935                        sp: Span,
2936                        expected: Expectation<'tcx>) -> Ty<'tcx> {
2937         let cond_ty = self.check_expr_meets_expectation_or_error(cond_expr, ExpectIfCondition);
2938         let cond_diverges = self.diverges.get();
2939         self.diverges.set(Diverges::Maybe);
2940
2941         let expected = expected.adjust_for_branches(self);
2942         let then_ty = self.check_expr_with_expectation(then_expr, expected);
2943         let then_diverges = self.diverges.get();
2944         self.diverges.set(Diverges::Maybe);
2945
2946         // We've already taken the expected type's preferences
2947         // into account when typing the `then` branch. To figure
2948         // out the initial shot at a LUB, we thus only consider
2949         // `expected` if it represents a *hard* constraint
2950         // (`only_has_type`); otherwise, we just go with a
2951         // fresh type variable.
2952         let coerce_to_ty = expected.coercion_target_type(self, sp);
2953         let mut coerce: DynamicCoerceMany = CoerceMany::new(coerce_to_ty);
2954
2955         let if_cause = self.cause(sp, ObligationCauseCode::IfExpression);
2956         coerce.coerce(self, &if_cause, then_expr, then_ty, then_diverges);
2957
2958         if let Some(else_expr) = opt_else_expr {
2959             let else_ty = self.check_expr_with_expectation(else_expr, expected);
2960             let else_diverges = self.diverges.get();
2961
2962             coerce.coerce(self, &if_cause, else_expr, else_ty, else_diverges);
2963
2964             // We won't diverge unless both branches do (or the condition does).
2965             self.diverges.set(cond_diverges | then_diverges & else_diverges);
2966         } else {
2967             let else_cause = self.cause(sp, ObligationCauseCode::IfExpressionWithNoElse);
2968             coerce.coerce_forced_unit(self, &else_cause, &mut |_| (), true);
2969
2970             // If the condition is false we can't diverge.
2971             self.diverges.set(cond_diverges);
2972         }
2973
2974         let result_ty = coerce.complete(self);
2975         if cond_ty.references_error() {
2976             self.tcx.types.err
2977         } else {
2978             result_ty
2979         }
2980     }
2981
2982     // Check field access expressions
2983     fn check_field(&self,
2984                    expr: &'gcx hir::Expr,
2985                    lvalue_pref: LvaluePreference,
2986                    base: &'gcx hir::Expr,
2987                    field: &Spanned<ast::Name>) -> Ty<'tcx> {
2988         let expr_t = self.check_expr_with_lvalue_pref(base, lvalue_pref);
2989         let expr_t = self.structurally_resolved_type(expr.span,
2990                                                      expr_t);
2991         let mut private_candidate = None;
2992         let mut autoderef = self.autoderef(expr.span, expr_t);
2993         while let Some((base_t, _)) = autoderef.next() {
2994             match base_t.sty {
2995                 ty::TyAdt(base_def, substs) if !base_def.is_enum() => {
2996                     debug!("struct named {:?}",  base_t);
2997                     let (ident, def_scope) =
2998                         self.tcx.adjust(field.node, base_def.did, self.body_id);
2999                     let fields = &base_def.struct_variant().fields;
3000                     if let Some(field) = fields.iter().find(|f| f.name.to_ident() == ident) {
3001                         let field_ty = self.field_ty(expr.span, field, substs);
3002                         if field.vis.is_accessible_from(def_scope, self.tcx) {
3003                             let adjustments = autoderef.adjust_steps(lvalue_pref);
3004                             self.apply_adjustments(base, adjustments);
3005                             autoderef.finalize();
3006
3007                             self.tcx.check_stability(field.did, expr.id, expr.span);
3008
3009                             return field_ty;
3010                         }
3011                         private_candidate = Some((base_def.did, field_ty));
3012                     }
3013                 }
3014                 _ => {}
3015             }
3016         }
3017         autoderef.unambiguous_final_ty();
3018
3019         if let Some((did, field_ty)) = private_candidate {
3020             let struct_path = self.tcx().item_path_str(did);
3021             let mut err = struct_span_err!(self.tcx().sess, expr.span, E0616,
3022                                            "field `{}` of struct `{}` is private",
3023                                            field.node, struct_path);
3024             // Also check if an accessible method exists, which is often what is meant.
3025             if self.method_exists(field.span, field.node, expr_t, expr.id, false) {
3026                 err.note(&format!("a method `{}` also exists, perhaps you wish to call it",
3027                                   field.node));
3028             }
3029             err.emit();
3030             field_ty
3031         } else if field.node == keywords::Invalid.name() {
3032             self.tcx().types.err
3033         } else if self.method_exists(field.span, field.node, expr_t, expr.id, true) {
3034             type_error_struct!(self.tcx().sess, field.span, expr_t, E0615,
3035                               "attempted to take value of method `{}` on type `{}`",
3036                               field.node, expr_t)
3037                 .help("maybe a `()` to call it is missing?")
3038                 .emit();
3039             self.tcx().types.err
3040         } else {
3041             if !expr_t.is_primitive_ty() {
3042                 let mut err = self.no_such_field_err(field.span, &field.node, expr_t);
3043
3044                 match expr_t.sty {
3045                     ty::TyAdt(def, _) if !def.is_enum() => {
3046                         if let Some(suggested_field_name) =
3047                             Self::suggest_field_name(def.struct_variant(), field, vec![]) {
3048                                 err.span_label(field.span,
3049                                                format!("did you mean `{}`?", suggested_field_name));
3050                             } else {
3051                                 err.span_label(field.span, "unknown field");
3052                                 let struct_variant_def = def.struct_variant();
3053                                 let field_names = self.available_field_names(struct_variant_def);
3054                                 if !field_names.is_empty() {
3055                                     err.note(&format!("available fields are: {}",
3056                                                       self.name_series_display(field_names)));
3057                                 }
3058                             };
3059                     }
3060                     ty::TyRawPtr(..) => {
3061                         err.note(&format!("`{0}` is a native pointer; perhaps you need to deref \
3062                                            with `(*{0}).{1}`",
3063                                           self.tcx.hir.node_to_pretty_string(base.id),
3064                                           field.node));
3065                     }
3066                     _ => {}
3067                 }
3068                 err
3069             } else {
3070                 type_error_struct!(self.tcx().sess, field.span, expr_t, E0610,
3071                                    "`{}` is a primitive type and therefore doesn't have fields",
3072                                    expr_t)
3073             }.emit();
3074             self.tcx().types.err
3075         }
3076     }
3077
3078     // Return an hint about the closest match in field names
3079     fn suggest_field_name(variant: &'tcx ty::VariantDef,
3080                           field: &Spanned<ast::Name>,
3081                           skip: Vec<InternedString>)
3082                           -> Option<Symbol> {
3083         let name = field.node.as_str();
3084         let names = variant.fields.iter().filter_map(|field| {
3085             // ignore already set fields and private fields from non-local crates
3086             if skip.iter().any(|x| *x == field.name.as_str()) ||
3087                (variant.did.krate != LOCAL_CRATE && field.vis != Visibility::Public) {
3088                 None
3089             } else {
3090                 Some(&field.name)
3091             }
3092         });
3093
3094         find_best_match_for_name(names, &name, None)
3095     }
3096
3097     fn available_field_names(&self, variant: &'tcx ty::VariantDef) -> Vec<ast::Name> {
3098         let mut available = Vec::new();
3099         for field in variant.fields.iter() {
3100             let (_, def_scope) = self.tcx.adjust(field.name, variant.did, self.body_id);
3101             if field.vis.is_accessible_from(def_scope, self.tcx) {
3102                 available.push(field.name);
3103             }
3104         }
3105         available
3106     }
3107
3108     fn name_series_display(&self, names: Vec<ast::Name>) -> String {
3109         // dynamic limit, to never omit just one field
3110         let limit = if names.len() == 6 { 6 } else { 5 };
3111         let mut display = names.iter().take(limit)
3112             .map(|n| format!("`{}`", n)).collect::<Vec<_>>().join(", ");
3113         if names.len() > limit {
3114             display = format!("{} ... and {} others", display, names.len() - limit);
3115         }
3116         display
3117     }
3118
3119     // Check tuple index expressions
3120     fn check_tup_field(&self,
3121                        expr: &'gcx hir::Expr,
3122                        lvalue_pref: LvaluePreference,
3123                        base: &'gcx hir::Expr,
3124                        idx: codemap::Spanned<usize>) -> Ty<'tcx> {
3125         let expr_t = self.check_expr_with_lvalue_pref(base, lvalue_pref);
3126         let expr_t = self.structurally_resolved_type(expr.span,
3127                                                      expr_t);
3128         let mut private_candidate = None;
3129         let mut tuple_like = false;
3130         let mut autoderef = self.autoderef(expr.span, expr_t);
3131         while let Some((base_t, _)) = autoderef.next() {
3132             let field = match base_t.sty {
3133                 ty::TyAdt(base_def, substs) if base_def.is_struct() => {
3134                     tuple_like = base_def.struct_variant().ctor_kind == CtorKind::Fn;
3135                     if !tuple_like { continue }
3136
3137                     debug!("tuple struct named {:?}",  base_t);
3138                     let ident = ast::Ident {
3139                         name: Symbol::intern(&idx.node.to_string()),
3140                         ctxt: idx.span.ctxt().modern(),
3141                     };
3142                     let (ident, def_scope) =
3143                         self.tcx.adjust_ident(ident, base_def.did, self.body_id);
3144                     let fields = &base_def.struct_variant().fields;
3145                     if let Some(field) = fields.iter().find(|f| f.name.to_ident() == ident) {
3146                         let field_ty = self.field_ty(expr.span, field, substs);
3147                         if field.vis.is_accessible_from(def_scope, self.tcx) {
3148                             self.tcx.check_stability(field.did, expr.id, expr.span);
3149                             Some(field_ty)
3150                         } else {
3151                             private_candidate = Some((base_def.did, field_ty));
3152                             None
3153                         }
3154                     } else {
3155                         None
3156                     }
3157                 }
3158                 ty::TyTuple(ref v, _) => {
3159                     tuple_like = true;
3160                     v.get(idx.node).cloned()
3161                 }
3162                 _ => continue
3163             };
3164
3165             if let Some(field_ty) = field {
3166                 let adjustments = autoderef.adjust_steps(lvalue_pref);
3167                 self.apply_adjustments(base, adjustments);
3168                 autoderef.finalize();
3169                 return field_ty;
3170             }
3171         }
3172         autoderef.unambiguous_final_ty();
3173
3174         if let Some((did, field_ty)) = private_candidate {
3175             let struct_path = self.tcx().item_path_str(did);
3176             struct_span_err!(self.tcx().sess, expr.span, E0611,
3177                              "field `{}` of tuple-struct `{}` is private",
3178                              idx.node, struct_path).emit();
3179             return field_ty;
3180         }
3181
3182         if tuple_like {
3183             type_error_struct!(self.tcx().sess, expr.span, expr_t, E0612,
3184                 "attempted out-of-bounds tuple index `{}` on type `{}`",
3185                 idx.node, expr_t).emit();
3186         } else {
3187             self.no_such_field_err(expr.span, idx.node, expr_t).emit();
3188         }
3189
3190         self.tcx().types.err
3191     }
3192
3193     fn no_such_field_err<T: Display>(&self, span: Span, field: T, expr_t: &ty::TyS)
3194         -> DiagnosticBuilder {
3195         type_error_struct!(self.tcx().sess, span, expr_t, E0609,
3196                            "no field `{}` on type `{}`",
3197                            field, expr_t)
3198     }
3199
3200     fn report_unknown_field(&self,
3201                             ty: Ty<'tcx>,
3202                             variant: &'tcx ty::VariantDef,
3203                             field: &hir::Field,
3204                             skip_fields: &[hir::Field],
3205                             kind_name: &str) {
3206         let mut err = self.type_error_struct_with_diag(
3207             field.name.span,
3208             |actual| match ty.sty {
3209                 ty::TyAdt(adt, ..) if adt.is_enum() => {
3210                     struct_span_err!(self.tcx.sess, field.name.span, E0559,
3211                                     "{} `{}::{}` has no field named `{}`",
3212                                     kind_name, actual, variant.name, field.name.node)
3213                 }
3214                 _ => {
3215                     struct_span_err!(self.tcx.sess, field.name.span, E0560,
3216                                     "{} `{}` has no field named `{}`",
3217                                     kind_name, actual, field.name.node)
3218                 }
3219             },
3220             ty);
3221         // prevent all specified fields from being suggested
3222         let skip_fields = skip_fields.iter().map(|ref x| x.name.node.as_str());
3223         if let Some(field_name) = Self::suggest_field_name(variant,
3224                                                            &field.name,
3225                                                            skip_fields.collect()) {
3226             err.span_label(field.name.span,
3227                            format!("field does not exist - did you mean `{}`?", field_name));
3228         } else {
3229             match ty.sty {
3230                 ty::TyAdt(adt, ..) => {
3231                     if adt.is_enum() {
3232                         err.span_label(field.name.span,
3233                                        format!("`{}::{}` does not have this field",
3234                                                ty, variant.name));
3235                     } else {
3236                         err.span_label(field.name.span,
3237                                        format!("`{}` does not have this field", ty));
3238                     }
3239                     let available_field_names = self.available_field_names(variant);
3240                     if !available_field_names.is_empty() {
3241                         err.note(&format!("available fields are: {}",
3242                                           self.name_series_display(available_field_names)));
3243                     }
3244                 }
3245                 _ => bug!("non-ADT passed to report_unknown_field")
3246             }
3247         };
3248         err.emit();
3249     }
3250
3251     fn check_expr_struct_fields(&self,
3252                                 adt_ty: Ty<'tcx>,
3253                                 expected: Expectation<'tcx>,
3254                                 expr_id: ast::NodeId,
3255                                 span: Span,
3256                                 variant: &'tcx ty::VariantDef,
3257                                 ast_fields: &'gcx [hir::Field],
3258                                 check_completeness: bool) {
3259         let tcx = self.tcx;
3260
3261         let adt_ty_hint =
3262             self.expected_inputs_for_expected_output(span, expected, adt_ty, &[adt_ty])
3263                 .get(0).cloned().unwrap_or(adt_ty);
3264         // re-link the regions that EIfEO can erase.
3265         self.demand_eqtype(span, adt_ty_hint, adt_ty);
3266
3267         let (substs, adt_kind, kind_name) = match &adt_ty.sty{
3268             &ty::TyAdt(adt, substs) => {
3269                 (substs, adt.adt_kind(), adt.variant_descr())
3270             }
3271             _ => span_bug!(span, "non-ADT passed to check_expr_struct_fields")
3272         };
3273
3274         let mut remaining_fields = FxHashMap();
3275         for field in &variant.fields {
3276             remaining_fields.insert(field.name.to_ident(), field);
3277         }
3278
3279         let mut seen_fields = FxHashMap();
3280
3281         let mut error_happened = false;
3282
3283         // Typecheck each field.
3284         for field in ast_fields {
3285             let ident = tcx.adjust(field.name.node, variant.did, self.body_id).0;
3286             let field_type = if let Some(v_field) = remaining_fields.remove(&ident) {
3287                 seen_fields.insert(field.name.node, field.span);
3288
3289                 // we don't look at stability attributes on
3290                 // struct-like enums (yet...), but it's definitely not
3291                 // a bug to have construct one.
3292                 if adt_kind != ty::AdtKind::Enum {
3293                     tcx.check_stability(v_field.did, expr_id, field.span);
3294                 }
3295
3296                 self.field_ty(field.span, v_field, substs)
3297             } else {
3298                 error_happened = true;
3299                 if let Some(_) = variant.find_field_named(field.name.node) {
3300                     let mut err = struct_span_err!(self.tcx.sess,
3301                                                 field.name.span,
3302                                                 E0062,
3303                                                 "field `{}` specified more than once",
3304                                                 field.name.node);
3305
3306                     err.span_label(field.name.span, "used more than once");
3307
3308                     if let Some(prev_span) = seen_fields.get(&field.name.node) {
3309                         err.span_label(*prev_span, format!("first use of `{}`", field.name.node));
3310                     }
3311
3312                     err.emit();
3313                 } else {
3314                     self.report_unknown_field(adt_ty, variant, field, ast_fields, kind_name);
3315                 }
3316
3317                 tcx.types.err
3318             };
3319
3320             // Make sure to give a type to the field even if there's
3321             // an error, so we can continue typechecking
3322             self.check_expr_coercable_to_type(&field.expr, field_type);
3323         }
3324
3325         // Make sure the programmer specified correct number of fields.
3326         if kind_name == "union" {
3327             if ast_fields.len() != 1 {
3328                 tcx.sess.span_err(span, "union expressions should have exactly one field");
3329             }
3330         } else if check_completeness && !error_happened && !remaining_fields.is_empty() {
3331             let len = remaining_fields.len();
3332
3333             let mut displayable_field_names = remaining_fields
3334                                               .keys()
3335                                               .map(|ident| ident.name.as_str())
3336                                               .collect::<Vec<_>>();
3337
3338             displayable_field_names.sort();
3339
3340             let truncated_fields_error = if len <= 3 {
3341                 "".to_string()
3342             } else {
3343                 format!(" and {} other field{}", (len - 3), if len - 3 == 1 {""} else {"s"})
3344             };
3345
3346             let remaining_fields_names = displayable_field_names.iter().take(3)
3347                                         .map(|n| format!("`{}`", n))
3348                                         .collect::<Vec<_>>()
3349                                         .join(", ");
3350
3351             struct_span_err!(tcx.sess, span, E0063,
3352                              "missing field{} {}{} in initializer of `{}`",
3353                              if remaining_fields.len() == 1 { "" } else { "s" },
3354                              remaining_fields_names,
3355                              truncated_fields_error,
3356                              adt_ty)
3357                 .span_label(span, format!("missing {}{}",
3358                                           remaining_fields_names,
3359                                           truncated_fields_error))
3360                 .emit();
3361         }
3362     }
3363
3364     fn check_struct_fields_on_error(&self,
3365                                     fields: &'gcx [hir::Field],
3366                                     base_expr: &'gcx Option<P<hir::Expr>>) {
3367         for field in fields {
3368             self.check_expr(&field.expr);
3369         }
3370         match *base_expr {
3371             Some(ref base) => {
3372                 self.check_expr(&base);
3373             },
3374             None => {}
3375         }
3376     }
3377
3378     pub fn check_struct_path(&self,
3379                              qpath: &hir::QPath,
3380                              node_id: ast::NodeId)
3381                              -> Option<(&'tcx ty::VariantDef,  Ty<'tcx>)> {
3382         let path_span = match *qpath {
3383             hir::QPath::Resolved(_, ref path) => path.span,
3384             hir::QPath::TypeRelative(ref qself, _) => qself.span
3385         };
3386         let (def, ty) = self.finish_resolving_struct_path(qpath, path_span, node_id);
3387         let variant = match def {
3388             Def::Err => {
3389                 self.set_tainted_by_errors();
3390                 return None;
3391             }
3392             Def::Variant(..) => {
3393                 match ty.sty {
3394                     ty::TyAdt(adt, substs) => {
3395                         Some((adt.variant_of_def(def), adt.did, substs))
3396                     }
3397                     _ => bug!("unexpected type: {:?}", ty.sty)
3398                 }
3399             }
3400             Def::Struct(..) | Def::Union(..) | Def::TyAlias(..) |
3401             Def::AssociatedTy(..) | Def::SelfTy(..) => {
3402                 match ty.sty {
3403                     ty::TyAdt(adt, substs) if !adt.is_enum() => {
3404                         Some((adt.struct_variant(), adt.did, substs))
3405                     }
3406                     _ => None,
3407                 }
3408             }
3409             _ => bug!("unexpected definition: {:?}", def)
3410         };
3411
3412         if let Some((variant, did, substs)) = variant {
3413             // Check bounds on type arguments used in the path.
3414             let bounds = self.instantiate_bounds(path_span, did, substs);
3415             let cause = traits::ObligationCause::new(path_span, self.body_id,
3416                                                      traits::ItemObligation(did));
3417             self.add_obligations_for_parameters(cause, &bounds);
3418
3419             Some((variant, ty))
3420         } else {
3421             struct_span_err!(self.tcx.sess, path_span, E0071,
3422                              "expected struct, variant or union type, found {}",
3423                              ty.sort_string(self.tcx))
3424                 .span_label(path_span, "not a struct")
3425                 .emit();
3426             None
3427         }
3428     }
3429
3430     fn check_expr_struct(&self,
3431                          expr: &hir::Expr,
3432                          expected: Expectation<'tcx>,
3433                          qpath: &hir::QPath,
3434                          fields: &'gcx [hir::Field],
3435                          base_expr: &'gcx Option<P<hir::Expr>>) -> Ty<'tcx>
3436     {
3437         // Find the relevant variant
3438         let (variant, struct_ty) =
3439         if let Some(variant_ty) = self.check_struct_path(qpath, expr.id) {
3440             variant_ty
3441         } else {
3442             self.check_struct_fields_on_error(fields, base_expr);
3443             return self.tcx.types.err;
3444         };
3445
3446         let path_span = match *qpath {
3447             hir::QPath::Resolved(_, ref path) => path.span,
3448             hir::QPath::TypeRelative(ref qself, _) => qself.span
3449         };
3450
3451         self.check_expr_struct_fields(struct_ty, expected, expr.id, path_span, variant, fields,
3452                                       base_expr.is_none());
3453         if let &Some(ref base_expr) = base_expr {
3454             self.check_expr_has_type_or_error(base_expr, struct_ty);
3455             match struct_ty.sty {
3456                 ty::TyAdt(adt, substs) if adt.is_struct() => {
3457                     let fru_field_types = adt.struct_variant().fields.iter().map(|f| {
3458                         self.normalize_associated_types_in(expr.span, &f.ty(self.tcx, substs))
3459                     }).collect();
3460
3461                     self.tables
3462                         .borrow_mut()
3463                         .fru_field_types_mut()
3464                         .insert(expr.hir_id, fru_field_types);
3465                 }
3466                 _ => {
3467                     span_err!(self.tcx.sess, base_expr.span, E0436,
3468                               "functional record update syntax requires a struct");
3469                 }
3470             }
3471         }
3472         self.require_type_is_sized(struct_ty, expr.span, traits::StructInitializerSized);
3473         struct_ty
3474     }
3475
3476
3477     /// Invariant:
3478     /// If an expression has any sub-expressions that result in a type error,
3479     /// inspecting that expression's type with `ty.references_error()` will return
3480     /// true. Likewise, if an expression is known to diverge, inspecting its
3481     /// type with `ty::type_is_bot` will return true (n.b.: since Rust is
3482     /// strict, _|_ can appear in the type of an expression that does not,
3483     /// itself, diverge: for example, fn() -> _|_.)
3484     /// Note that inspecting a type's structure *directly* may expose the fact
3485     /// that there are actually multiple representations for `TyError`, so avoid
3486     /// that when err needs to be handled differently.
3487     fn check_expr_with_expectation_and_lvalue_pref(&self,
3488                                                    expr: &'gcx hir::Expr,
3489                                                    expected: Expectation<'tcx>,
3490                                                    lvalue_pref: LvaluePreference) -> Ty<'tcx> {
3491         debug!(">> typechecking: expr={:?} expected={:?}",
3492                expr, expected);
3493
3494         // Warn for expressions after diverging siblings.
3495         self.warn_if_unreachable(expr.id, expr.span, "expression");
3496
3497         // Hide the outer diverging and has_errors flags.
3498         let old_diverges = self.diverges.get();
3499         let old_has_errors = self.has_errors.get();
3500         self.diverges.set(Diverges::Maybe);
3501         self.has_errors.set(false);
3502
3503         let ty = self.check_expr_kind(expr, expected, lvalue_pref);
3504
3505         // Warn for non-block expressions with diverging children.
3506         match expr.node {
3507             hir::ExprBlock(_) |
3508             hir::ExprLoop(..) | hir::ExprWhile(..) |
3509             hir::ExprIf(..) | hir::ExprMatch(..) => {}
3510
3511             _ => self.warn_if_unreachable(expr.id, expr.span, "expression")
3512         }
3513
3514         // Any expression that produces a value of type `!` must have diverged
3515         if ty.is_never() {
3516             self.diverges.set(self.diverges.get() | Diverges::Always);
3517         }
3518
3519         // Record the type, which applies it effects.
3520         // We need to do this after the warning above, so that
3521         // we don't warn for the diverging expression itself.
3522         self.write_ty(expr.hir_id, ty);
3523
3524         // Combine the diverging and has_error flags.
3525         self.diverges.set(self.diverges.get() | old_diverges);
3526         self.has_errors.set(self.has_errors.get() | old_has_errors);
3527
3528         debug!("type of {} is...", self.tcx.hir.node_to_string(expr.id));
3529         debug!("... {:?}, expected is {:?}", ty, expected);
3530
3531         ty
3532     }
3533
3534     fn check_expr_kind(&self,
3535                        expr: &'gcx hir::Expr,
3536                        expected: Expectation<'tcx>,
3537                        lvalue_pref: LvaluePreference) -> Ty<'tcx> {
3538         let tcx = self.tcx;
3539         let id = expr.id;
3540         match expr.node {
3541           hir::ExprBox(ref subexpr) => {
3542             let expected_inner = expected.to_option(self).map_or(NoExpectation, |ty| {
3543                 match ty.sty {
3544                     ty::TyAdt(def, _) if def.is_box()
3545                         => Expectation::rvalue_hint(self, ty.boxed_ty()),
3546                     _ => NoExpectation
3547                 }
3548             });
3549             let referent_ty = self.check_expr_with_expectation(subexpr, expected_inner);
3550             tcx.mk_box(referent_ty)
3551           }
3552
3553           hir::ExprLit(ref lit) => {
3554             self.check_lit(&lit, expected)
3555           }
3556           hir::ExprBinary(op, ref lhs, ref rhs) => {
3557             self.check_binop(expr, op, lhs, rhs)
3558           }
3559           hir::ExprAssignOp(op, ref lhs, ref rhs) => {
3560             self.check_binop_assign(expr, op, lhs, rhs)
3561           }
3562           hir::ExprUnary(unop, ref oprnd) => {
3563             let expected_inner = match unop {
3564                 hir::UnNot | hir::UnNeg => {
3565                     expected
3566                 }
3567                 hir::UnDeref => {
3568                     NoExpectation
3569                 }
3570             };
3571             let lvalue_pref = match unop {
3572                 hir::UnDeref => lvalue_pref,
3573                 _ => NoPreference
3574             };
3575             let mut oprnd_t = self.check_expr_with_expectation_and_lvalue_pref(&oprnd,
3576                                                                                expected_inner,
3577                                                                                lvalue_pref);
3578
3579             if !oprnd_t.references_error() {
3580                 oprnd_t = self.structurally_resolved_type(expr.span, oprnd_t);
3581                 match unop {
3582                     hir::UnDeref => {
3583                         if let Some(mt) = oprnd_t.builtin_deref(true, NoPreference) {
3584                             oprnd_t = mt.ty;
3585                         } else if let Some(ok) = self.try_overloaded_deref(
3586                                 expr.span, oprnd_t, lvalue_pref) {
3587                             let method = self.register_infer_ok_obligations(ok);
3588                             if let ty::TyRef(region, mt) = method.sig.inputs()[0].sty {
3589                                 self.apply_adjustments(oprnd, vec![Adjustment {
3590                                     kind: Adjust::Borrow(AutoBorrow::Ref(region, mt.mutbl)),
3591                                     target: method.sig.inputs()[0]
3592                                 }]);
3593                             }
3594                             oprnd_t = self.make_overloaded_lvalue_return_type(method).ty;
3595                             self.write_method_call(expr.hir_id, method);
3596                         } else {
3597                             type_error_struct!(tcx.sess, expr.span, oprnd_t, E0614,
3598                                                "type `{}` cannot be dereferenced",
3599                                                oprnd_t).emit();
3600                             oprnd_t = tcx.types.err;
3601                         }
3602                     }
3603                     hir::UnNot => {
3604                         let result = self.check_user_unop(expr, oprnd_t, unop);
3605                         // If it's builtin, we can reuse the type, this helps inference.
3606                         if !(oprnd_t.is_integral() || oprnd_t.sty == ty::TyBool) {
3607                             oprnd_t = result;
3608                         }
3609                     }
3610                     hir::UnNeg => {
3611                         let result = self.check_user_unop(expr, oprnd_t, unop);
3612                         // If it's builtin, we can reuse the type, this helps inference.
3613                         if !(oprnd_t.is_integral() || oprnd_t.is_fp()) {
3614                             oprnd_t = result;
3615                         }
3616                     }
3617                 }
3618             }
3619             oprnd_t
3620           }
3621           hir::ExprAddrOf(mutbl, ref oprnd) => {
3622             let hint = expected.only_has_type(self).map_or(NoExpectation, |ty| {
3623                 match ty.sty {
3624                     ty::TyRef(_, ref mt) | ty::TyRawPtr(ref mt) => {
3625                         if self.tcx.expr_is_lval(&oprnd) {
3626                             // Lvalues may legitimately have unsized types.
3627                             // For example, dereferences of a fat pointer and
3628                             // the last field of a struct can be unsized.
3629                             ExpectHasType(mt.ty)
3630                         } else {
3631                             Expectation::rvalue_hint(self, mt.ty)
3632                         }
3633                     }
3634                     _ => NoExpectation
3635                 }
3636             });
3637             let lvalue_pref = LvaluePreference::from_mutbl(mutbl);
3638             let ty = self.check_expr_with_expectation_and_lvalue_pref(&oprnd, hint, lvalue_pref);
3639
3640             let tm = ty::TypeAndMut { ty: ty, mutbl: mutbl };
3641             if tm.ty.references_error() {
3642                 tcx.types.err
3643             } else {
3644                 // Note: at this point, we cannot say what the best lifetime
3645                 // is to use for resulting pointer.  We want to use the
3646                 // shortest lifetime possible so as to avoid spurious borrowck
3647                 // errors.  Moreover, the longest lifetime will depend on the
3648                 // precise details of the value whose address is being taken
3649                 // (and how long it is valid), which we don't know yet until type
3650                 // inference is complete.
3651                 //
3652                 // Therefore, here we simply generate a region variable.  The
3653                 // region inferencer will then select the ultimate value.
3654                 // Finally, borrowck is charged with guaranteeing that the
3655                 // value whose address was taken can actually be made to live
3656                 // as long as it needs to live.
3657                 let region = self.next_region_var(infer::AddrOfRegion(expr.span));
3658                 tcx.mk_ref(region, tm)
3659             }
3660           }
3661           hir::ExprPath(ref qpath) => {
3662               let (def, opt_ty, segments) = self.resolve_ty_and_def_ufcs(qpath,
3663                                                                          expr.id, expr.span);
3664               let ty = if def != Def::Err {
3665                   self.instantiate_value_path(segments, opt_ty, def, expr.span, id)
3666               } else {
3667                   self.set_tainted_by_errors();
3668                   tcx.types.err
3669               };
3670
3671               // We always require that the type provided as the value for
3672               // a type parameter outlives the moment of instantiation.
3673               let substs = self.tables.borrow().node_substs(expr.hir_id);
3674               self.add_wf_bounds(substs, expr);
3675
3676               ty
3677           }
3678           hir::ExprInlineAsm(_, ref outputs, ref inputs) => {
3679               for output in outputs {
3680                   self.check_expr(output);
3681               }
3682               for input in inputs {
3683                   self.check_expr(input);
3684               }
3685               tcx.mk_nil()
3686           }
3687           hir::ExprBreak(destination, ref expr_opt) => {
3688               if let Some(target_id) = destination.target_id.opt_id() {
3689                   let (e_ty, e_diverges, cause);
3690                   if let Some(ref e) = *expr_opt {
3691                       // If this is a break with a value, we need to type-check
3692                       // the expression. Get an expected type from the loop context.
3693                       let opt_coerce_to = {
3694                           let mut enclosing_breakables = self.enclosing_breakables.borrow_mut();
3695                           enclosing_breakables.find_breakable(target_id)
3696                                               .coerce
3697                                               .as_ref()
3698                                               .map(|coerce| coerce.expected_ty())
3699                       };
3700
3701                       // If the loop context is not a `loop { }`, then break with
3702                       // a value is illegal, and `opt_coerce_to` will be `None`.
3703                       // Just set expectation to error in that case.
3704                       let coerce_to = opt_coerce_to.unwrap_or(tcx.types.err);
3705
3706                       // Recurse without `enclosing_breakables` borrowed.
3707                       e_ty = self.check_expr_with_hint(e, coerce_to);
3708                       e_diverges = self.diverges.get();
3709                       cause = self.misc(e.span);
3710                   } else {
3711                       // Otherwise, this is a break *without* a value. That's
3712                       // always legal, and is equivalent to `break ()`.
3713                       e_ty = tcx.mk_nil();
3714                       e_diverges = Diverges::Maybe;
3715                       cause = self.misc(expr.span);
3716                   }
3717
3718                   // Now that we have type-checked `expr_opt`, borrow
3719                   // the `enclosing_loops` field and let's coerce the
3720                   // type of `expr_opt` into what is expected.
3721                   let mut enclosing_breakables = self.enclosing_breakables.borrow_mut();
3722                   let ctxt = enclosing_breakables.find_breakable(target_id);
3723                   if let Some(ref mut coerce) = ctxt.coerce {
3724                       if let Some(ref e) = *expr_opt {
3725                           coerce.coerce(self, &cause, e, e_ty, e_diverges);
3726                       } else {
3727                           assert!(e_ty.is_nil());
3728                           coerce.coerce_forced_unit(self, &cause, &mut |_| (), true);
3729                       }
3730                   } else {
3731                       // If `ctxt.coerce` is `None`, we can just ignore
3732                       // the type of the expresison.  This is because
3733                       // either this was a break *without* a value, in
3734                       // which case it is always a legal type (`()`), or
3735                       // else an error would have been flagged by the
3736                       // `loops` pass for using break with an expression
3737                       // where you are not supposed to.
3738                       assert!(expr_opt.is_none() || self.tcx.sess.err_count() > 0);
3739                   }
3740
3741                   ctxt.may_break = true;
3742               } else {
3743                   // Otherwise, we failed to find the enclosing loop;
3744                   // this can only happen if the `break` was not
3745                   // inside a loop at all, which is caught by the
3746                   // loop-checking pass.
3747                   assert!(self.tcx.sess.err_count() > 0);
3748
3749                   // We still need to assign a type to the inner expression to
3750                   // prevent the ICE in #43162.
3751                   if let Some(ref e) = *expr_opt {
3752                       self.check_expr_with_hint(e, tcx.types.err);
3753
3754                       // ... except when we try to 'break rust;'.
3755                       // ICE this expression in particular (see #43162).
3756                       if let hir::ExprPath(hir::QPath::Resolved(_, ref path)) = e.node {
3757                           if path.segments.len() == 1 && path.segments[0].name == "rust" {
3758                               fatally_break_rust(self.tcx.sess);
3759                           }
3760                       }
3761                   }
3762               }
3763
3764               // the type of a `break` is always `!`, since it diverges
3765               tcx.types.never
3766           }
3767           hir::ExprAgain(_) => { tcx.types.never }
3768           hir::ExprRet(ref expr_opt) => {
3769             if self.ret_coercion.is_none() {
3770                 struct_span_err!(self.tcx.sess, expr.span, E0572,
3771                                  "return statement outside of function body").emit();
3772             } else if let Some(ref e) = *expr_opt {
3773                 self.check_return_expr(e);
3774             } else {
3775                 let mut coercion = self.ret_coercion.as_ref().unwrap().borrow_mut();
3776                 let cause = self.cause(expr.span, ObligationCauseCode::ReturnNoExpression);
3777                 coercion.coerce_forced_unit(self, &cause, &mut |_| (), true);
3778             }
3779             tcx.types.never
3780           }
3781           hir::ExprAssign(ref lhs, ref rhs) => {
3782             let lhs_ty = self.check_expr_with_lvalue_pref(&lhs, PreferMutLvalue);
3783
3784             let rhs_ty = self.check_expr_coercable_to_type(&rhs, lhs_ty);
3785
3786             match expected {
3787                 ExpectIfCondition => {
3788                     self.tcx.sess.delay_span_bug(lhs.span, "invalid lhs expression in if;\
3789                                                             expected error elsehwere");
3790                 }
3791                 _ => {
3792                     // Only check this if not in an `if` condition, as the
3793                     // mistyped comparison help is more appropriate.
3794                     if !self.tcx.expr_is_lval(&lhs) {
3795                         struct_span_err!(self.tcx.sess, expr.span, E0070,
3796                                          "invalid left-hand side expression")
3797                             .span_label(expr.span, "left-hand of expression not valid")
3798                             .emit();
3799                     }
3800                 }
3801             }
3802
3803             self.require_type_is_sized(lhs_ty, lhs.span, traits::AssignmentLhsSized);
3804
3805             if lhs_ty.references_error() || rhs_ty.references_error() {
3806                 tcx.types.err
3807             } else {
3808                 tcx.mk_nil()
3809             }
3810           }
3811           hir::ExprIf(ref cond, ref then_expr, ref opt_else_expr) => {
3812               self.check_then_else(&cond, then_expr, opt_else_expr.as_ref().map(|e| &**e),
3813                                    expr.span, expected)
3814           }
3815           hir::ExprWhile(ref cond, ref body, _) => {
3816               let ctxt = BreakableCtxt {
3817                   // cannot use break with a value from a while loop
3818                   coerce: None,
3819                   may_break: true,
3820               };
3821
3822               self.with_breakable_ctxt(expr.id, ctxt, || {
3823                   self.check_expr_has_type_or_error(&cond, tcx.types.bool);
3824                   let cond_diverging = self.diverges.get();
3825                   self.check_block_no_value(&body);
3826
3827                   // We may never reach the body so it diverging means nothing.
3828                   self.diverges.set(cond_diverging);
3829               });
3830
3831               self.tcx.mk_nil()
3832           }
3833           hir::ExprLoop(ref body, _, source) => {
3834               let coerce = match source {
3835                   // you can only use break with a value from a normal `loop { }`
3836                   hir::LoopSource::Loop => {
3837                       let coerce_to = expected.coercion_target_type(self, body.span);
3838                       Some(CoerceMany::new(coerce_to))
3839                   }
3840
3841                   hir::LoopSource::WhileLet |
3842                   hir::LoopSource::ForLoop => {
3843                       None
3844                   }
3845               };
3846
3847               let ctxt = BreakableCtxt {
3848                   coerce,
3849                   may_break: false, // will get updated if/when we find a `break`
3850               };
3851
3852               let (ctxt, ()) = self.with_breakable_ctxt(expr.id, ctxt, || {
3853                   self.check_block_no_value(&body);
3854               });
3855
3856               if ctxt.may_break {
3857                   // No way to know whether it's diverging because
3858                   // of a `break` or an outer `break` or `return.
3859                   self.diverges.set(Diverges::Maybe);
3860               }
3861
3862               // If we permit break with a value, then result type is
3863               // the LUB of the breaks (possibly ! if none); else, it
3864               // is nil. This makes sense because infinite loops
3865               // (which would have type !) are only possible iff we
3866               // permit break with a value [1].
3867               assert!(ctxt.coerce.is_some() || ctxt.may_break); // [1]
3868               ctxt.coerce.map(|c| c.complete(self)).unwrap_or(self.tcx.mk_nil())
3869           }
3870           hir::ExprMatch(ref discrim, ref arms, match_src) => {
3871             self.check_match(expr, &discrim, arms, expected, match_src)
3872           }
3873           hir::ExprClosure(capture, ref decl, body_id, _, _) => {
3874               self.check_expr_closure(expr, capture, &decl, body_id, expected)
3875           }
3876           hir::ExprBlock(ref body) => {
3877             self.check_block_with_expected(&body, expected)
3878           }
3879           hir::ExprCall(ref callee, ref args) => {
3880               self.check_call(expr, &callee, args, expected)
3881           }
3882           hir::ExprMethodCall(ref segment, span, ref args) => {
3883               self.check_method_call(expr, segment, span, args, expected, lvalue_pref)
3884           }
3885           hir::ExprCast(ref e, ref t) => {
3886             // Find the type of `e`. Supply hints based on the type we are casting to,
3887             // if appropriate.
3888             let t_cast = self.to_ty(t);
3889             let t_cast = self.resolve_type_vars_if_possible(&t_cast);
3890             let t_expr = self.check_expr_with_expectation(e, ExpectCastableToType(t_cast));
3891             let t_cast = self.resolve_type_vars_if_possible(&t_cast);
3892             let diverges = self.diverges.get();
3893
3894             // Eagerly check for some obvious errors.
3895             if t_expr.references_error() || t_cast.references_error() {
3896                 tcx.types.err
3897             } else {
3898                 // Defer other checks until we're done type checking.
3899                 let mut deferred_cast_checks = self.deferred_cast_checks.borrow_mut();
3900                 match cast::CastCheck::new(self, e, t_expr, diverges, t_cast, t.span, expr.span) {
3901                     Ok(cast_check) => {
3902                         deferred_cast_checks.push(cast_check);
3903                         t_cast
3904                     }
3905                     Err(ErrorReported) => {
3906                         tcx.types.err
3907                     }
3908                 }
3909             }
3910           }
3911           hir::ExprType(ref e, ref t) => {
3912             let typ = self.to_ty(&t);
3913             self.check_expr_eq_type(&e, typ);
3914             typ
3915           }
3916           hir::ExprArray(ref args) => {
3917               let uty = expected.to_option(self).and_then(|uty| {
3918                   match uty.sty {
3919                       ty::TyArray(ty, _) | ty::TySlice(ty) => Some(ty),
3920                       _ => None
3921                   }
3922               });
3923
3924               let element_ty = if !args.is_empty() {
3925                   let coerce_to = uty.unwrap_or_else(
3926                       || self.next_ty_var(TypeVariableOrigin::TypeInference(expr.span)));
3927                   let mut coerce = CoerceMany::with_coercion_sites(coerce_to, args);
3928                   assert_eq!(self.diverges.get(), Diverges::Maybe);
3929                   for e in args {
3930                       let e_ty = self.check_expr_with_hint(e, coerce_to);
3931                       let cause = self.misc(e.span);
3932                       coerce.coerce(self, &cause, e, e_ty, self.diverges.get());
3933                   }
3934                   coerce.complete(self)
3935               } else {
3936                   self.next_ty_var(TypeVariableOrigin::TypeInference(expr.span))
3937               };
3938               tcx.mk_array(element_ty, args.len() as u64)
3939           }
3940           hir::ExprRepeat(ref element, count) => {
3941             let count_def_id = tcx.hir.body_owner_def_id(count);
3942             let param_env = ty::ParamEnv::empty(traits::Reveal::UserFacing);
3943             let substs = Substs::identity_for_item(tcx.global_tcx(), count_def_id);
3944             let count = tcx.const_eval(param_env.and((count_def_id, substs)));
3945
3946             if let Err(ref err) = count {
3947                err.report(tcx, tcx.def_span(count_def_id), "constant expression");
3948             }
3949
3950             let uty = match expected {
3951                 ExpectHasType(uty) => {
3952                     match uty.sty {
3953                         ty::TyArray(ty, _) | ty::TySlice(ty) => Some(ty),
3954                         _ => None
3955                     }
3956                 }
3957                 _ => None
3958             };
3959
3960             let (element_ty, t) = match uty {
3961                 Some(uty) => {
3962                     self.check_expr_coercable_to_type(&element, uty);
3963                     (uty, uty)
3964                 }
3965                 None => {
3966                     let t: Ty = self.next_ty_var(TypeVariableOrigin::MiscVariable(element.span));
3967                     let element_ty = self.check_expr_has_type_or_error(&element, t);
3968                     (element_ty, t)
3969                 }
3970             };
3971
3972             if let Ok(count) = count {
3973                 let zero_or_one = count.val.to_const_int().and_then(|count| {
3974                     count.to_u64().map(|count| count <= 1)
3975                 }).unwrap_or(false);
3976                 if !zero_or_one {
3977                     // For [foo, ..n] where n > 1, `foo` must have
3978                     // Copy type:
3979                     let lang_item = self.tcx.require_lang_item(lang_items::CopyTraitLangItem);
3980                     self.require_type_meets(t, expr.span, traits::RepeatVec, lang_item);
3981                 }
3982             }
3983
3984             if element_ty.references_error() {
3985                 tcx.types.err
3986             } else if let Ok(count) = count {
3987                 tcx.mk_ty(ty::TyArray(t, count))
3988             } else {
3989                 tcx.types.err
3990             }
3991           }
3992           hir::ExprTup(ref elts) => {
3993             let flds = expected.only_has_type(self).and_then(|ty| {
3994                 let ty = self.resolve_type_vars_with_obligations(ty);
3995                 match ty.sty {
3996                     ty::TyTuple(ref flds, _) => Some(&flds[..]),
3997                     _ => None
3998                 }
3999             });
4000
4001             let elt_ts_iter = elts.iter().enumerate().map(|(i, e)| {
4002                 let t = match flds {
4003                     Some(ref fs) if i < fs.len() => {
4004                         let ety = fs[i];
4005                         self.check_expr_coercable_to_type(&e, ety);
4006                         ety
4007                     }
4008                     _ => {
4009                         self.check_expr_with_expectation(&e, NoExpectation)
4010                     }
4011                 };
4012                 t
4013             });
4014             let tuple = tcx.mk_tup(elt_ts_iter, false);
4015             if tuple.references_error() {
4016                 tcx.types.err
4017             } else {
4018                 self.require_type_is_sized(tuple, expr.span, traits::TupleInitializerSized);
4019                 tuple
4020             }
4021           }
4022           hir::ExprStruct(ref qpath, ref fields, ref base_expr) => {
4023             self.check_expr_struct(expr, expected, qpath, fields, base_expr)
4024           }
4025           hir::ExprField(ref base, ref field) => {
4026             self.check_field(expr, lvalue_pref, &base, field)
4027           }
4028           hir::ExprTupField(ref base, idx) => {
4029             self.check_tup_field(expr, lvalue_pref, &base, idx)
4030           }
4031           hir::ExprIndex(ref base, ref idx) => {
4032               let base_t = self.check_expr_with_lvalue_pref(&base, lvalue_pref);
4033               let idx_t = self.check_expr(&idx);
4034
4035               if base_t.references_error() {
4036                   base_t
4037               } else if idx_t.references_error() {
4038                   idx_t
4039               } else {
4040                   let base_t = self.structurally_resolved_type(expr.span, base_t);
4041                   match self.lookup_indexing(expr, base, base_t, idx_t, lvalue_pref) {
4042                       Some((index_ty, element_ty)) => {
4043                           self.demand_coerce(idx, idx_t, index_ty);
4044                           element_ty
4045                       }
4046                       None => {
4047                           let mut err = type_error_struct!(tcx.sess, expr.span, base_t, E0608,
4048                                                            "cannot index into a value of type `{}`",
4049                                                            base_t);
4050                           // Try to give some advice about indexing tuples.
4051                           if let ty::TyTuple(..) = base_t.sty {
4052                               let mut needs_note = true;
4053                               // If the index is an integer, we can show the actual
4054                               // fixed expression:
4055                               if let hir::ExprLit(ref lit) = idx.node {
4056                                   if let ast::LitKind::Int(i,
4057                                             ast::LitIntType::Unsuffixed) = lit.node {
4058                                       let snip = tcx.sess.codemap().span_to_snippet(base.span);
4059                                       if let Ok(snip) = snip {
4060                                           err.span_suggestion(expr.span,
4061                                                               "to access tuple elements, use",
4062                                                               format!("{}.{}", snip, i));
4063                                           needs_note = false;
4064                                       }
4065                                   }
4066                               }
4067                               if needs_note {
4068                                   err.help("to access tuple elements, use tuple indexing \
4069                                             syntax (e.g. `tuple.0`)");
4070                               }
4071                           }
4072                           err.emit();
4073                           self.tcx.types.err
4074                       }
4075                   }
4076               }
4077            }
4078           hir::ExprYield(ref value) => {
4079             match self.yield_ty {
4080                 Some(ty) => {
4081                     self.check_expr_coercable_to_type(&value, ty);
4082                 }
4083                 None => {
4084                     struct_span_err!(self.tcx.sess, expr.span, E0627,
4085                                  "yield statement outside of generator literal").emit();
4086                 }
4087             }
4088             tcx.mk_nil()
4089           }
4090         }
4091     }
4092
4093     // Finish resolving a path in a struct expression or pattern `S::A { .. }` if necessary.
4094     // The newly resolved definition is written into `type_dependent_defs`.
4095     fn finish_resolving_struct_path(&self,
4096                                     qpath: &hir::QPath,
4097                                     path_span: Span,
4098                                     node_id: ast::NodeId)
4099                                     -> (Def, Ty<'tcx>)
4100     {
4101         match *qpath {
4102             hir::QPath::Resolved(ref maybe_qself, ref path) => {
4103                 let opt_self_ty = maybe_qself.as_ref().map(|qself| self.to_ty(qself));
4104                 let ty = AstConv::def_to_ty(self, opt_self_ty, path, true);
4105                 (path.def, ty)
4106             }
4107             hir::QPath::TypeRelative(ref qself, ref segment) => {
4108                 let ty = self.to_ty(qself);
4109
4110                 let def = if let hir::TyPath(hir::QPath::Resolved(_, ref path)) = qself.node {
4111                     path.def
4112                 } else {
4113                     Def::Err
4114                 };
4115                 let (ty, def) = AstConv::associated_path_def_to_ty(self, node_id, path_span,
4116                                                                    ty, def, segment);
4117
4118                 // Write back the new resolution.
4119                 let hir_id = self.tcx.hir.node_to_hir_id(node_id);
4120                 self.tables.borrow_mut().type_dependent_defs_mut().insert(hir_id, def);
4121
4122                 (def, ty)
4123             }
4124         }
4125     }
4126
4127     // Resolve associated value path into a base type and associated constant or method definition.
4128     // The newly resolved definition is written into `type_dependent_defs`.
4129     pub fn resolve_ty_and_def_ufcs<'b>(&self,
4130                                        qpath: &'b hir::QPath,
4131                                        node_id: ast::NodeId,
4132                                        span: Span)
4133                                        -> (Def, Option<Ty<'tcx>>, &'b [hir::PathSegment])
4134     {
4135         let (ty, item_segment) = match *qpath {
4136             hir::QPath::Resolved(ref opt_qself, ref path) => {
4137                 return (path.def,
4138                         opt_qself.as_ref().map(|qself| self.to_ty(qself)),
4139                         &path.segments[..]);
4140             }
4141             hir::QPath::TypeRelative(ref qself, ref segment) => {
4142                 (self.to_ty(qself), segment)
4143             }
4144         };
4145         let hir_id = self.tcx.hir.node_to_hir_id(node_id);
4146         if let Some(cached_def) = self.tables.borrow().type_dependent_defs().get(hir_id) {
4147             // Return directly on cache hit. This is useful to avoid doubly reporting
4148             // errors with default match binding modes. See #44614.
4149             return (*cached_def, Some(ty), slice::ref_slice(&**item_segment))
4150         }
4151         let item_name = item_segment.name;
4152         let def = match self.resolve_ufcs(span, item_name, ty, node_id) {
4153             Ok(def) => def,
4154             Err(error) => {
4155                 let def = match error {
4156                     method::MethodError::PrivateMatch(def, _) => def,
4157                     _ => Def::Err,
4158                 };
4159                 if item_name != keywords::Invalid.name() {
4160                     self.report_method_error(span, ty, item_name, None, error, None);
4161                 }
4162                 def
4163             }
4164         };
4165
4166         // Write back the new resolution.
4167         self.tables.borrow_mut().type_dependent_defs_mut().insert(hir_id, def);
4168         (def, Some(ty), slice::ref_slice(&**item_segment))
4169     }
4170
4171     pub fn check_decl_initializer(&self,
4172                                   local: &'gcx hir::Local,
4173                                   init: &'gcx hir::Expr) -> Ty<'tcx>
4174     {
4175         // FIXME(tschottdorf): contains_explicit_ref_binding() must be removed
4176         // for #42640 (default match binding modes).
4177         //
4178         // See #44848.
4179         let ref_bindings = local.pat.contains_explicit_ref_binding();
4180
4181         let local_ty = self.local_ty(init.span, local.id);
4182         if let Some(m) = ref_bindings {
4183             // Somewhat subtle: if we have a `ref` binding in the pattern,
4184             // we want to avoid introducing coercions for the RHS. This is
4185             // both because it helps preserve sanity and, in the case of
4186             // ref mut, for soundness (issue #23116). In particular, in
4187             // the latter case, we need to be clear that the type of the
4188             // referent for the reference that results is *equal to* the
4189             // type of the lvalue it is referencing, and not some
4190             // supertype thereof.
4191             let init_ty = self.check_expr_with_lvalue_pref(init, LvaluePreference::from_mutbl(m));
4192             self.demand_eqtype(init.span, init_ty, local_ty);
4193             init_ty
4194         } else {
4195             self.check_expr_coercable_to_type(init, local_ty)
4196         }
4197     }
4198
4199     pub fn check_decl_local(&self, local: &'gcx hir::Local)  {
4200         let t = self.local_ty(local.span, local.id);
4201         self.write_ty(local.hir_id, t);
4202
4203         if let Some(ref init) = local.init {
4204             let init_ty = self.check_decl_initializer(local, &init);
4205             if init_ty.references_error() {
4206                 self.write_ty(local.hir_id, init_ty);
4207             }
4208         }
4209
4210         self.check_pat_walk(&local.pat, t,
4211                             ty::BindingMode::BindByValue(hir::Mutability::MutImmutable),
4212                             true);
4213         let pat_ty = self.node_ty(local.pat.hir_id);
4214         if pat_ty.references_error() {
4215             self.write_ty(local.hir_id, pat_ty);
4216         }
4217     }
4218
4219     pub fn check_stmt(&self, stmt: &'gcx hir::Stmt) {
4220         // Don't do all the complex logic below for DeclItem.
4221         match stmt.node {
4222             hir::StmtDecl(ref decl, _) => {
4223                 match decl.node {
4224                     hir::DeclLocal(_) => {}
4225                     hir::DeclItem(_) => {
4226                         return;
4227                     }
4228                 }
4229             }
4230             hir::StmtExpr(..) | hir::StmtSemi(..) => {}
4231         }
4232
4233         self.warn_if_unreachable(stmt.node.id(), stmt.span, "statement");
4234
4235         // Hide the outer diverging and has_errors flags.
4236         let old_diverges = self.diverges.get();
4237         let old_has_errors = self.has_errors.get();
4238         self.diverges.set(Diverges::Maybe);
4239         self.has_errors.set(false);
4240
4241         match stmt.node {
4242             hir::StmtDecl(ref decl, _) => {
4243                 match decl.node {
4244                     hir::DeclLocal(ref l) => {
4245                         self.check_decl_local(&l);
4246                     }
4247                     hir::DeclItem(_) => {/* ignore for now */}
4248                 }
4249             }
4250             hir::StmtExpr(ref expr, _) => {
4251                 // Check with expected type of ()
4252                 self.check_expr_has_type_or_error(&expr, self.tcx.mk_nil());
4253             }
4254             hir::StmtSemi(ref expr, _) => {
4255                 self.check_expr(&expr);
4256             }
4257         }
4258
4259         // Combine the diverging and has_error flags.
4260         self.diverges.set(self.diverges.get() | old_diverges);
4261         self.has_errors.set(self.has_errors.get() | old_has_errors);
4262     }
4263
4264     pub fn check_block_no_value(&self, blk: &'gcx hir::Block)  {
4265         let unit = self.tcx.mk_nil();
4266         let ty = self.check_block_with_expected(blk, ExpectHasType(unit));
4267
4268         // if the block produces a `!` value, that can always be
4269         // (effectively) coerced to unit.
4270         if !ty.is_never() {
4271             self.demand_suptype(blk.span, unit, ty);
4272         }
4273     }
4274
4275     fn check_block_with_expected(&self,
4276                                  blk: &'gcx hir::Block,
4277                                  expected: Expectation<'tcx>) -> Ty<'tcx> {
4278         let prev = {
4279             let mut fcx_ps = self.ps.borrow_mut();
4280             let unsafety_state = fcx_ps.recurse(blk);
4281             replace(&mut *fcx_ps, unsafety_state)
4282         };
4283
4284         // In some cases, blocks have just one exit, but other blocks
4285         // can be targeted by multiple breaks. This cannot happen in
4286         // normal Rust syntax today, but it can happen when we desugar
4287         // a `do catch { ... }` expression.
4288         //
4289         // Example 1:
4290         //
4291         //    'a: { if true { break 'a Err(()); } Ok(()) }
4292         //
4293         // Here we would wind up with two coercions, one from
4294         // `Err(())` and the other from the tail expression
4295         // `Ok(())`. If the tail expression is omitted, that's a
4296         // "forced unit" -- unless the block diverges, in which
4297         // case we can ignore the tail expression (e.g., `'a: {
4298         // break 'a 22; }` would not force the type of the block
4299         // to be `()`).
4300         let tail_expr = blk.expr.as_ref();
4301         let coerce_to_ty = expected.coercion_target_type(self, blk.span);
4302         let coerce = if blk.targeted_by_break {
4303             CoerceMany::new(coerce_to_ty)
4304         } else {
4305             let tail_expr: &[P<hir::Expr>] = match tail_expr {
4306                 Some(e) => ref_slice(e),
4307                 None => &[],
4308             };
4309             CoerceMany::with_coercion_sites(coerce_to_ty, tail_expr)
4310         };
4311
4312         let prev_diverges = self.diverges.get();
4313         let ctxt = BreakableCtxt {
4314             coerce: Some(coerce),
4315             may_break: false,
4316         };
4317
4318         let (ctxt, ()) = self.with_breakable_ctxt(blk.id, ctxt, || {
4319             for s in &blk.stmts {
4320                 self.check_stmt(s);
4321             }
4322
4323             // check the tail expression **without** holding the
4324             // `enclosing_breakables` lock below.
4325             let tail_expr_ty = tail_expr.map(|t| self.check_expr_with_expectation(t, expected));
4326
4327             let mut enclosing_breakables = self.enclosing_breakables.borrow_mut();
4328             let ctxt = enclosing_breakables.find_breakable(blk.id);
4329             let coerce = ctxt.coerce.as_mut().unwrap();
4330             if let Some(tail_expr_ty) = tail_expr_ty {
4331                 let tail_expr = tail_expr.unwrap();
4332                 let cause = self.cause(tail_expr.span,
4333                                        ObligationCauseCode::BlockTailExpression(blk.id));
4334                 coerce.coerce(self,
4335                               &cause,
4336                               tail_expr,
4337                               tail_expr_ty,
4338                               self.diverges.get());
4339             } else {
4340                 // Subtle: if there is no explicit tail expression,
4341                 // that is typically equivalent to a tail expression
4342                 // of `()` -- except if the block diverges. In that
4343                 // case, there is no value supplied from the tail
4344                 // expression (assuming there are no other breaks,
4345                 // this implies that the type of the block will be
4346                 // `!`).
4347                 //
4348                 // #41425 -- label the implicit `()` as being the
4349                 // "found type" here, rather than the "expected type".
4350                 if !self.diverges.get().always() {
4351                     coerce.coerce_forced_unit(self, &self.misc(blk.span), &mut |err| {
4352                         if let Some(expected_ty) = expected.only_has_type(self) {
4353                             self.consider_hint_about_removing_semicolon(blk,
4354                                                                         expected_ty,
4355                                                                         err);
4356                         }
4357                     }, false);
4358                 }
4359             }
4360         });
4361
4362         if ctxt.may_break {
4363             // If we can break from the block, then the block's exit is always reachable
4364             // (... as long as the entry is reachable) - regardless of the tail of the block.
4365             self.diverges.set(prev_diverges);
4366         }
4367
4368         let mut ty = ctxt.coerce.unwrap().complete(self);
4369
4370         if self.has_errors.get() || ty.references_error() {
4371             ty = self.tcx.types.err
4372         }
4373
4374         self.write_ty(blk.hir_id, ty);
4375
4376         *self.ps.borrow_mut() = prev;
4377         ty
4378     }
4379
4380     /// Given a `NodeId`, return the `FnDecl` of the method it is enclosed by and whether a
4381     /// suggestion can be made, `None` otherwise.
4382     pub fn get_fn_decl(&self, blk_id: ast::NodeId) -> Option<(hir::FnDecl, bool)> {
4383         // Get enclosing Fn, if it is a function or a trait method, unless there's a `loop` or
4384         // `while` before reaching it, as block tail returns are not available in them.
4385         if let Some(fn_id) = self.tcx.hir.get_return_block(blk_id) {
4386             let parent = self.tcx.hir.get(fn_id);
4387
4388             if let Node::NodeItem(&hir::Item {
4389                 name, node: hir::ItemFn(ref decl, ..), ..
4390             }) = parent {
4391                 decl.clone().and_then(|decl| {
4392                     // This is less than ideal, it will not suggest a return type span on any
4393                     // method called `main`, regardless of whether it is actually the entry point,
4394                     // but it will still present it as the reason for the expected type.
4395                     Some((decl, name != Symbol::intern("main")))
4396                 })
4397             } else if let Node::NodeTraitItem(&hir::TraitItem {
4398                 node: hir::TraitItemKind::Method(hir::MethodSig {
4399                     ref decl, ..
4400                 }, ..), ..
4401             }) = parent {
4402                 decl.clone().and_then(|decl| {
4403                     Some((decl, true))
4404                 })
4405             } else if let Node::NodeImplItem(&hir::ImplItem {
4406                 node: hir::ImplItemKind::Method(hir::MethodSig {
4407                     ref decl, ..
4408                 }, ..), ..
4409             }) = parent {
4410                 decl.clone().and_then(|decl| {
4411                     Some((decl, false))
4412                 })
4413             } else {
4414                 None
4415             }
4416         } else {
4417             None
4418         }
4419     }
4420
4421     /// On implicit return expressions with mismatched types, provide the following suggestions:
4422     ///
4423     ///  - Point out the method's return type as the reason for the expected type
4424     ///  - Possible missing semicolon
4425     ///  - Possible missing return type if the return type is the default, and not `fn main()`
4426     pub fn suggest_mismatched_types_on_tail(&self,
4427                                             err: &mut DiagnosticBuilder<'tcx>,
4428                                             expression: &'gcx hir::Expr,
4429                                             expected: Ty<'tcx>,
4430                                             found: Ty<'tcx>,
4431                                             cause_span: Span,
4432                                             blk_id: ast::NodeId) {
4433         self.suggest_missing_semicolon(err, expression, expected, cause_span);
4434
4435         if let Some((fn_decl, can_suggest)) = self.get_fn_decl(blk_id) {
4436             self.suggest_missing_return_type(err, &fn_decl, expected, found, can_suggest);
4437         }
4438     }
4439
4440     /// A common error is to forget to add a semicolon at the end of a block:
4441     ///
4442     /// ```
4443     /// fn foo() {
4444     ///     bar_that_returns_u32()
4445     /// }
4446     /// ```
4447     ///
4448     /// This routine checks if the return expression in a block would make sense on its own as a
4449     /// statement and the return type has been left as default or has been specified as `()`. If so,
4450     /// it suggests adding a semicolon.
4451     fn suggest_missing_semicolon(&self,
4452                                      err: &mut DiagnosticBuilder<'tcx>,
4453                                      expression: &'gcx hir::Expr,
4454                                      expected: Ty<'tcx>,
4455                                      cause_span: Span) {
4456         if expected.is_nil() {
4457             // `BlockTailExpression` only relevant if the tail expr would be
4458             // useful on its own.
4459             match expression.node {
4460                 hir::ExprCall(..) |
4461                 hir::ExprMethodCall(..) |
4462                 hir::ExprIf(..) |
4463                 hir::ExprWhile(..) |
4464                 hir::ExprLoop(..) |
4465                 hir::ExprMatch(..) |
4466                 hir::ExprBlock(..) => {
4467                     let sp = cause_span.next_point();
4468                     err.span_suggestion(sp,
4469                                         "try adding a semicolon",
4470                                         ";".to_string());
4471                 }
4472                 _ => (),
4473             }
4474         }
4475     }
4476
4477
4478     /// A possible error is to forget to add a return type that is needed:
4479     ///
4480     /// ```
4481     /// fn foo() {
4482     ///     bar_that_returns_u32()
4483     /// }
4484     /// ```
4485     ///
4486     /// This routine checks if the return type is left as default, the method is not part of an
4487     /// `impl` block and that it isn't the `main` method. If so, it suggests setting the return
4488     /// type.
4489     fn suggest_missing_return_type(&self,
4490                                    err: &mut DiagnosticBuilder<'tcx>,
4491                                    fn_decl: &hir::FnDecl,
4492                                    expected: Ty<'tcx>,
4493                                    found: Ty<'tcx>,
4494                                    can_suggest: bool) {
4495         // Only suggest changing the return type for methods that
4496         // haven't set a return type at all (and aren't `fn main()` or an impl).
4497         match (&fn_decl.output, found.is_suggestable(), can_suggest) {
4498             (&hir::FunctionRetTy::DefaultReturn(span), true, true) => {
4499                 err.span_suggestion(span,
4500                                     "try adding a return type",
4501                                     format!("-> {} ", found));
4502             }
4503             (&hir::FunctionRetTy::DefaultReturn(span), false, true) => {
4504                 err.span_label(span, "possibly return type missing here?");
4505             }
4506             (&hir::FunctionRetTy::DefaultReturn(span), _, _) => {
4507                 // `fn main()` must return `()`, do not suggest changing return type
4508                 err.span_label(span, "expected `()` because of default return type");
4509             }
4510             (&hir::FunctionRetTy::Return(ref ty), _, _) => {
4511                 // Only point to return type if the expected type is the return type, as if they
4512                 // are not, the expectation must have been caused by something else.
4513                 debug!("suggest_missing_return_type: return type {:?} node {:?}", ty, ty.node);
4514                 let sp = ty.span;
4515                 let ty = AstConv::ast_ty_to_ty(self, ty);
4516                 debug!("suggest_missing_return_type: return type sty {:?}", ty.sty);
4517                 debug!("suggest_missing_return_type: expected type sty {:?}", ty.sty);
4518                 if ty.sty == expected.sty {
4519                     err.span_label(sp, format!("expected `{}` because of return type",
4520                                                expected));
4521                 }
4522             }
4523         }
4524     }
4525
4526
4527     /// A common error is to add an extra semicolon:
4528     ///
4529     /// ```
4530     /// fn foo() -> usize {
4531     ///     22;
4532     /// }
4533     /// ```
4534     ///
4535     /// This routine checks if the final statement in a block is an
4536     /// expression with an explicit semicolon whose type is compatible
4537     /// with `expected_ty`. If so, it suggests removing the semicolon.
4538     fn consider_hint_about_removing_semicolon(&self,
4539                                               blk: &'gcx hir::Block,
4540                                               expected_ty: Ty<'tcx>,
4541                                               err: &mut DiagnosticBuilder) {
4542         // Be helpful when the user wrote `{... expr;}` and
4543         // taking the `;` off is enough to fix the error.
4544         let last_stmt = match blk.stmts.last() {
4545             Some(s) => s,
4546             None => return,
4547         };
4548         let last_expr = match last_stmt.node {
4549             hir::StmtSemi(ref e, _) => e,
4550             _ => return,
4551         };
4552         let last_expr_ty = self.node_ty(last_expr.hir_id);
4553         if self.can_sub(self.param_env, last_expr_ty, expected_ty).is_err() {
4554             return;
4555         }
4556         let original_span = original_sp(last_stmt.span, blk.span);
4557         let span_semi = original_span.with_lo(original_span.hi() - BytePos(1));
4558         err.span_suggestion(span_semi, "consider removing this semicolon", "".to_string());
4559     }
4560
4561     // Instantiates the given path, which must refer to an item with the given
4562     // number of type parameters and type.
4563     pub fn instantiate_value_path(&self,
4564                                   segments: &[hir::PathSegment],
4565                                   opt_self_ty: Option<Ty<'tcx>>,
4566                                   def: Def,
4567                                   span: Span,
4568                                   node_id: ast::NodeId)
4569                                   -> Ty<'tcx> {
4570         debug!("instantiate_value_path(path={:?}, def={:?}, node_id={})",
4571                segments,
4572                def,
4573                node_id);
4574
4575         // We need to extract the type parameters supplied by the user in
4576         // the path `path`. Due to the current setup, this is a bit of a
4577         // tricky-process; the problem is that resolve only tells us the
4578         // end-point of the path resolution, and not the intermediate steps.
4579         // Luckily, we can (at least for now) deduce the intermediate steps
4580         // just from the end-point.
4581         //
4582         // There are basically four cases to consider:
4583         //
4584         // 1. Reference to a constructor of enum variant or struct:
4585         //
4586         //        struct Foo<T>(...)
4587         //        enum E<T> { Foo(...) }
4588         //
4589         //    In these cases, the parameters are declared in the type
4590         //    space.
4591         //
4592         // 2. Reference to a fn item or a free constant:
4593         //
4594         //        fn foo<T>() { }
4595         //
4596         //    In this case, the path will again always have the form
4597         //    `a::b::foo::<T>` where only the final segment should have
4598         //    type parameters. However, in this case, those parameters are
4599         //    declared on a value, and hence are in the `FnSpace`.
4600         //
4601         // 3. Reference to a method or an associated constant:
4602         //
4603         //        impl<A> SomeStruct<A> {
4604         //            fn foo<B>(...)
4605         //        }
4606         //
4607         //    Here we can have a path like
4608         //    `a::b::SomeStruct::<A>::foo::<B>`, in which case parameters
4609         //    may appear in two places. The penultimate segment,
4610         //    `SomeStruct::<A>`, contains parameters in TypeSpace, and the
4611         //    final segment, `foo::<B>` contains parameters in fn space.
4612         //
4613         // 4. Reference to a local variable
4614         //
4615         //    Local variables can't have any type parameters.
4616         //
4617         // The first step then is to categorize the segments appropriately.
4618
4619         assert!(!segments.is_empty());
4620
4621         let mut ufcs_associated = None;
4622         let mut type_segment = None;
4623         let mut fn_segment = None;
4624         match def {
4625             // Case 1. Reference to a struct/variant constructor.
4626             Def::StructCtor(def_id, ..) |
4627             Def::VariantCtor(def_id, ..) => {
4628                 // Everything but the final segment should have no
4629                 // parameters at all.
4630                 let mut generics = self.tcx.generics_of(def_id);
4631                 if let Some(def_id) = generics.parent {
4632                     // Variant and struct constructors use the
4633                     // generics of their parent type definition.
4634                     generics = self.tcx.generics_of(def_id);
4635                 }
4636                 type_segment = Some((segments.last().unwrap(), generics));
4637             }
4638
4639             // Case 2. Reference to a top-level value.
4640             Def::Fn(def_id) |
4641             Def::Const(def_id) |
4642             Def::Static(def_id, _) => {
4643                 fn_segment = Some((segments.last().unwrap(),
4644                                    self.tcx.generics_of(def_id)));
4645             }
4646
4647             // Case 3. Reference to a method or associated const.
4648             Def::Method(def_id) |
4649             Def::AssociatedConst(def_id) => {
4650                 let container = self.tcx.associated_item(def_id).container;
4651                 match container {
4652                     ty::TraitContainer(trait_did) => {
4653                         callee::check_legal_trait_for_method_call(self.tcx, span, trait_did)
4654                     }
4655                     ty::ImplContainer(_) => {}
4656                 }
4657
4658                 let generics = self.tcx.generics_of(def_id);
4659                 if segments.len() >= 2 {
4660                     let parent_generics = self.tcx.generics_of(generics.parent.unwrap());
4661                     type_segment = Some((&segments[segments.len() - 2], parent_generics));
4662                 } else {
4663                     // `<T>::assoc` will end up here, and so can `T::assoc`.
4664                     let self_ty = opt_self_ty.expect("UFCS sugared assoc missing Self");
4665                     ufcs_associated = Some((container, self_ty));
4666                 }
4667                 fn_segment = Some((segments.last().unwrap(), generics));
4668             }
4669
4670             // Case 4. Local variable, no generics.
4671             Def::Local(..) | Def::Upvar(..) => {}
4672
4673             _ => bug!("unexpected definition: {:?}", def),
4674         }
4675
4676         debug!("type_segment={:?} fn_segment={:?}", type_segment, fn_segment);
4677
4678         // Now that we have categorized what space the parameters for each
4679         // segment belong to, let's sort out the parameters that the user
4680         // provided (if any) into their appropriate spaces. We'll also report
4681         // errors if type parameters are provided in an inappropriate place.
4682         let poly_segments = type_segment.is_some() as usize +
4683                             fn_segment.is_some() as usize;
4684         AstConv::prohibit_type_params(self, &segments[..segments.len() - poly_segments]);
4685
4686         match def {
4687             Def::Local(nid) | Def::Upvar(nid, ..) => {
4688                 let ty = self.local_ty(span, nid);
4689                 let ty = self.normalize_associated_types_in(span, &ty);
4690                 self.write_ty(self.tcx.hir.node_to_hir_id(node_id), ty);
4691                 return ty;
4692             }
4693             _ => {}
4694         }
4695
4696         // Now we have to compare the types that the user *actually*
4697         // provided against the types that were *expected*. If the user
4698         // did not provide any types, then we want to substitute inference
4699         // variables. If the user provided some types, we may still need
4700         // to add defaults. If the user provided *too many* types, that's
4701         // a problem.
4702         self.check_path_parameter_count(span, &mut type_segment, false);
4703         self.check_path_parameter_count(span, &mut fn_segment, false);
4704         self.check_impl_trait(span, &mut fn_segment);
4705
4706         let (fn_start, has_self) = match (type_segment, fn_segment) {
4707             (_, Some((_, generics))) => {
4708                 (generics.parent_count(), generics.has_self)
4709             }
4710             (Some((_, generics)), None) => {
4711                 (generics.own_count(), generics.has_self)
4712             }
4713             (None, None) => (0, false)
4714         };
4715         let substs = Substs::for_item(self.tcx, def.def_id(), |def, _| {
4716             let mut i = def.index as usize;
4717
4718             let segment = if i < fn_start {
4719                 i -= has_self as usize;
4720                 type_segment
4721             } else {
4722                 i -= fn_start;
4723                 fn_segment
4724             };
4725             let lifetimes = segment.map_or(&[][..], |(s, _)| {
4726                 s.parameters.as_ref().map_or(&[][..], |p| &p.lifetimes[..])
4727             });
4728
4729             if let Some(lifetime) = lifetimes.get(i) {
4730                 AstConv::ast_region_to_region(self, lifetime, Some(def))
4731             } else {
4732                 self.re_infer(span, Some(def)).unwrap()
4733             }
4734         }, |def, substs| {
4735             let mut i = def.index as usize;
4736
4737             let segment = if i < fn_start {
4738                 // Handle Self first, so we can adjust the index to match the AST.
4739                 if has_self && i == 0 {
4740                     return opt_self_ty.unwrap_or_else(|| {
4741                         self.type_var_for_def(span, def, substs)
4742                     });
4743                 }
4744                 i -= has_self as usize;
4745                 type_segment
4746             } else {
4747                 i -= fn_start;
4748                 fn_segment
4749             };
4750             let (types, infer_types) = segment.map_or((&[][..], true), |(s, _)| {
4751                 (s.parameters.as_ref().map_or(&[][..], |p| &p.types[..]), s.infer_types)
4752             });
4753
4754             // Skip over the lifetimes in the same segment.
4755             if let Some((_, generics)) = segment {
4756                 i -= generics.regions.len();
4757             }
4758
4759             if let Some(ast_ty) = types.get(i) {
4760                 // A provided type parameter.
4761                 self.to_ty(ast_ty)
4762             } else if !infer_types && def.has_default {
4763                 // No type parameter provided, but a default exists.
4764                 let default = self.tcx.type_of(def.def_id);
4765                 self.normalize_ty(
4766                     span,
4767                     default.subst_spanned(self.tcx, substs, Some(span))
4768                 )
4769             } else {
4770                 // No type parameters were provided, we can infer all.
4771                 // This can also be reached in some error cases:
4772                 // We prefer to use inference variables instead of
4773                 // TyError to let type inference recover somewhat.
4774                 self.type_var_for_def(span, def, substs)
4775             }
4776         });
4777
4778         // The things we are substituting into the type should not contain
4779         // escaping late-bound regions, and nor should the base type scheme.
4780         let ty = self.tcx.type_of(def.def_id());
4781         assert!(!substs.has_escaping_regions());
4782         assert!(!ty.has_escaping_regions());
4783
4784         // Add all the obligations that are required, substituting and
4785         // normalized appropriately.
4786         let bounds = self.instantiate_bounds(span, def.def_id(), &substs);
4787         self.add_obligations_for_parameters(
4788             traits::ObligationCause::new(span, self.body_id, traits::ItemObligation(def.def_id())),
4789             &bounds);
4790
4791         // Substitute the values for the type parameters into the type of
4792         // the referenced item.
4793         let ty_substituted = self.instantiate_type_scheme(span, &substs, &ty);
4794
4795         if let Some((ty::ImplContainer(impl_def_id), self_ty)) = ufcs_associated {
4796             // In the case of `Foo<T>::method` and `<Foo<T>>::method`, if `method`
4797             // is inherent, there is no `Self` parameter, instead, the impl needs
4798             // type parameters, which we can infer by unifying the provided `Self`
4799             // with the substituted impl type.
4800             let ty = self.tcx.type_of(impl_def_id);
4801
4802             let impl_ty = self.instantiate_type_scheme(span, &substs, &ty);
4803             match self.at(&self.misc(span), self.param_env).sup(impl_ty, self_ty) {
4804                 Ok(ok) => self.register_infer_ok_obligations(ok),
4805                 Err(_) => {
4806                     span_bug!(span,
4807                         "instantiate_value_path: (UFCS) {:?} was a subtype of {:?} but now is not?",
4808                         self_ty,
4809                         impl_ty);
4810                 }
4811             }
4812         }
4813
4814         debug!("instantiate_value_path: type of {:?} is {:?}",
4815                node_id,
4816                ty_substituted);
4817         self.write_substs(self.tcx.hir.node_to_hir_id(node_id), substs);
4818         ty_substituted
4819     }
4820
4821     /// Report errors if the provided parameters are too few or too many.
4822     fn check_path_parameter_count(&self,
4823                                   span: Span,
4824                                   segment: &mut Option<(&hir::PathSegment, &ty::Generics)>,
4825                                   is_method_call: bool) {
4826         let (lifetimes, types, infer_types, bindings) = segment.map_or(
4827             (&[][..], &[][..], true, &[][..]),
4828             |(s, _)| s.parameters.as_ref().map_or(
4829                 (&[][..], &[][..], s.infer_types, &[][..]),
4830                 |p| (&p.lifetimes[..], &p.types[..],
4831                      s.infer_types, &p.bindings[..])));
4832         let infer_lifetimes = lifetimes.len() == 0;
4833
4834         let count_lifetime_params = |n| {
4835             format!("{} lifetime parameter{}", n, if n == 1 { "" } else { "s" })
4836         };
4837         let count_type_params = |n| {
4838             format!("{} type parameter{}", n, if n == 1 { "" } else { "s" })
4839         };
4840
4841         // Check provided type parameters.
4842         let type_defs = segment.map_or(&[][..], |(_, generics)| {
4843             if generics.parent.is_none() {
4844                 &generics.types[generics.has_self as usize..]
4845             } else {
4846                 &generics.types
4847             }
4848         });
4849         let required_len = type_defs.iter().take_while(|d| !d.has_default).count();
4850         if types.len() > type_defs.len() {
4851             let span = types[type_defs.len()].span;
4852             let expected_text = count_type_params(type_defs.len());
4853             let actual_text = count_type_params(types.len());
4854             struct_span_err!(self.tcx.sess, span, E0087,
4855                              "too many type parameters provided: \
4856                               expected at most {}, found {}",
4857                              expected_text, actual_text)
4858                 .span_label(span, format!("expected {}", expected_text))
4859                 .emit();
4860
4861             // To prevent derived errors to accumulate due to extra
4862             // type parameters, we force instantiate_value_path to
4863             // use inference variables instead of the provided types.
4864             *segment = None;
4865         } else if types.len() < required_len && !infer_types {
4866             let expected_text = count_type_params(required_len);
4867             let actual_text = count_type_params(types.len());
4868             struct_span_err!(self.tcx.sess, span, E0089,
4869                              "too few type parameters provided: \
4870                               expected {}, found {}",
4871                              expected_text, actual_text)
4872                 .span_label(span, format!("expected {}", expected_text))
4873                 .emit();
4874         }
4875
4876         if !bindings.is_empty() {
4877             AstConv::prohibit_projection(self, bindings[0].span);
4878         }
4879
4880         // Check provided lifetime parameters.
4881         let lifetime_defs = segment.map_or(&[][..], |(_, generics)| &generics.regions);
4882         let required_len = lifetime_defs.len();
4883
4884         // Prohibit explicit lifetime arguments if late bound lifetime parameters are present.
4885         let has_late_bound_lifetime_defs =
4886             segment.map_or(None, |(_, generics)| generics.has_late_bound_regions);
4887         if let (Some(span_late), false) = (has_late_bound_lifetime_defs, lifetimes.is_empty()) {
4888             // Report this as a lint only if no error was reported previously.
4889             let primary_msg = "cannot specify lifetime arguments explicitly \
4890                                if late bound lifetime parameters are present";
4891             let note_msg = "the late bound lifetime parameter is introduced here";
4892             if !is_method_call && (lifetimes.len() > lifetime_defs.len() ||
4893                                    lifetimes.len() < required_len && !infer_lifetimes) {
4894                 let mut err = self.tcx.sess.struct_span_err(lifetimes[0].span, primary_msg);
4895                 err.span_note(span_late, note_msg);
4896                 err.emit();
4897                 *segment = None;
4898             } else {
4899                 let mut multispan = MultiSpan::from_span(lifetimes[0].span);
4900                 multispan.push_span_label(span_late, note_msg.to_string());
4901                 self.tcx.lint_node(lint::builtin::LATE_BOUND_LIFETIME_ARGUMENTS,
4902                                    lifetimes[0].id, multispan, primary_msg);
4903             }
4904             return;
4905         }
4906
4907         if lifetimes.len() > lifetime_defs.len() {
4908             let span = lifetimes[lifetime_defs.len()].span;
4909             let expected_text = count_lifetime_params(lifetime_defs.len());
4910             let actual_text = count_lifetime_params(lifetimes.len());
4911             struct_span_err!(self.tcx.sess, span, E0088,
4912                              "too many lifetime parameters provided: \
4913                               expected at most {}, found {}",
4914                              expected_text, actual_text)
4915                 .span_label(span, format!("expected {}", expected_text))
4916                 .emit();
4917         } else if lifetimes.len() < required_len && !infer_lifetimes {
4918             let expected_text = count_lifetime_params(lifetime_defs.len());
4919             let actual_text = count_lifetime_params(lifetimes.len());
4920             struct_span_err!(self.tcx.sess, span, E0090,
4921                              "too few lifetime parameters provided: \
4922                               expected {}, found {}",
4923                              expected_text, actual_text)
4924                 .span_label(span, format!("expected {}", expected_text))
4925                 .emit();
4926         }
4927     }
4928
4929     /// Report error if there is an explicit type parameter when using `impl Trait`.
4930     fn check_impl_trait(&self,
4931                         span: Span,
4932                         segment: &mut Option<(&hir::PathSegment, &ty::Generics)>) {
4933         use hir::SyntheticTyParamKind::*;
4934
4935         segment.map(|(path_segment, generics)| {
4936             let explicit = !path_segment.infer_types;
4937             let impl_trait = generics.types.iter()
4938                                            .any(|ty_param| {
4939                                                match ty_param.synthetic {
4940                                                    Some(ImplTrait) => true,
4941                                                    _ => false,
4942                                                }
4943                                            });
4944
4945             if explicit && impl_trait {
4946                 let mut err = struct_span_err! {
4947                     self.tcx.sess,
4948                     span,
4949                     E0632,
4950                     "cannot provide explicit type parameters when `impl Trait` is \
4951                     used in argument position."
4952                 };
4953
4954                 err.emit();
4955             }
4956         });
4957     }
4958
4959     fn structurally_resolve_type_or_else<F>(&self, sp: Span, ty: Ty<'tcx>, f: F)
4960                                             -> Ty<'tcx>
4961         where F: Fn() -> Ty<'tcx>
4962     {
4963         let mut ty = self.resolve_type_vars_with_obligations(ty);
4964
4965         if ty.is_ty_var() {
4966             let alternative = f();
4967
4968             // If not, error.
4969             if alternative.is_ty_var() || alternative.references_error() {
4970                 if !self.is_tainted_by_errors() {
4971                     type_error_struct!(self.tcx.sess, sp, ty, E0619,
4972                                        "the type of this value must be known in this context")
4973                         .emit();
4974                 }
4975                 self.demand_suptype(sp, self.tcx.types.err, ty);
4976                 ty = self.tcx.types.err;
4977             } else {
4978                 self.demand_suptype(sp, alternative, ty);
4979                 ty = alternative;
4980             }
4981         }
4982
4983         ty
4984     }
4985
4986     // Resolves `typ` by a single level if `typ` is a type variable.  If no
4987     // resolution is possible, then an error is reported.
4988     pub fn structurally_resolved_type(&self, sp: Span, ty: Ty<'tcx>) -> Ty<'tcx> {
4989         self.structurally_resolve_type_or_else(sp, ty, || {
4990             self.tcx.types.err
4991         })
4992     }
4993
4994     fn with_breakable_ctxt<F: FnOnce() -> R, R>(&self, id: ast::NodeId,
4995                                         ctxt: BreakableCtxt<'gcx, 'tcx>, f: F)
4996                                    -> (BreakableCtxt<'gcx, 'tcx>, R) {
4997         let index;
4998         {
4999             let mut enclosing_breakables = self.enclosing_breakables.borrow_mut();
5000             index = enclosing_breakables.stack.len();
5001             enclosing_breakables.by_id.insert(id, index);
5002             enclosing_breakables.stack.push(ctxt);
5003         }
5004         let result = f();
5005         let ctxt = {
5006             let mut enclosing_breakables = self.enclosing_breakables.borrow_mut();
5007             debug_assert!(enclosing_breakables.stack.len() == index + 1);
5008             enclosing_breakables.by_id.remove(&id).expect("missing breakable context");
5009             enclosing_breakables.stack.pop().expect("missing breakable context")
5010         };
5011         (ctxt, result)
5012     }
5013 }
5014
5015 pub fn check_bounds_are_used<'a, 'tcx>(tcx: TyCtxt<'a, 'tcx, 'tcx>,
5016                                        generics: &hir::Generics,
5017                                        ty: Ty<'tcx>) {
5018     debug!("check_bounds_are_used(n_tps={}, ty={:?})",
5019            generics.ty_params.len(),  ty);
5020
5021     // make a vector of booleans initially false, set to true when used
5022     if generics.ty_params.is_empty() { return; }
5023     let mut tps_used = vec![false; generics.ty_params.len()];
5024
5025     for leaf_ty in ty.walk() {
5026         if let ty::TyParam(ParamTy {idx, ..}) = leaf_ty.sty {
5027             debug!("Found use of ty param num {}", idx);
5028             tps_used[idx as usize - generics.lifetimes.len()] = true;
5029         }
5030     }
5031
5032     for (&used, param) in tps_used.iter().zip(&generics.ty_params) {
5033         if !used {
5034             struct_span_err!(tcx.sess, param.span, E0091,
5035                 "type parameter `{}` is unused",
5036                 param.name)
5037                 .span_label(param.span, "unused type parameter")
5038                 .emit();
5039         }
5040     }
5041 }
5042
5043 fn fatally_break_rust(sess: &Session) {
5044     let handler = sess.diagnostic();
5045     handler.span_bug_no_panic(
5046         MultiSpan::new(),
5047         "It looks like you're trying to break rust; would you like some ICE?",
5048     );
5049     handler.note_without_error("the compiler expectedly panicked. this is a feature.");
5050     handler.note_without_error(
5051         "we would appreciate a joke overview: \
5052         https://github.com/rust-lang/rust/issues/43162#issuecomment-320764675"
5053     );
5054     handler.note_without_error(&format!("rustc {} running on {}",
5055         option_env!("CFG_VERSION").unwrap_or("unknown_version"),
5056         ::session::config::host_triple(),
5057     ));
5058 }