src/librustc_typeck/check/upvar.rs

   1 //! ### Inferring borrow kinds for upvars
   2 //!
   3 //! Whenever there is a closure expression, we need to determine how each
   4 //! upvar is used. We do this by initially assigning each upvar an
   5 //! immutable "borrow kind" (see `ty::BorrowKind` for details) and then
   6 //! "escalating" the kind as needed. The borrow kind proceeds according to
   7 //! the following lattice:
   8 //!
   9 //!     ty::ImmBorrow -> ty::UniqueImmBorrow -> ty::MutBorrow
  10 //!
  11 //! So, for example, if we see an assignment `x = 5` to an upvar `x`, we
  12 //! will promote its borrow kind to mutable borrow. If we see an `&mut x`
  13 //! we'll do the same. Naturally, this applies not just to the upvar, but
  14 //! to everything owned by `x`, so the result is the same for something
  15 //! like `x.f = 5` and so on (presuming `x` is not a borrowed pointer to a
  16 //! struct). These adjustments are performed in
  17 //! `adjust_upvar_borrow_kind()` (you can trace backwards through the code
  18 //! from there).
  19 //!
  20 //! The fact that we are inferring borrow kinds as we go results in a
  21 //! semi-hacky interaction with mem-categorization. In particular,
  22 //! mem-categorization will query the current borrow kind as it
  23 //! categorizes, and we'll return the *current* value, but this may get
  24 //! adjusted later. Therefore, in this module, we generally ignore the
  25 //! borrow kind (and derived mutabilities) that are returned from
  26 //! mem-categorization, since they may be inaccurate. (Another option
  27 //! would be to use a unification scheme, where instead of returning a
  28 //! concrete borrow kind like `ty::ImmBorrow`, we return a
  29 //! `ty::InferBorrow(upvar_id)` or something like that, but this would
  30 //! then mean that all later passes would have to check for these figments
  31 //! and report an error, and it just seems like more mess in the end.)
  32
  33 use super::FnCtxt;
  34
  35 use crate::middle::expr_use_visitor as euv;
  36 use crate::middle::mem_categorization as mc;
  37 use crate::middle::mem_categorization::Categorization;
  38 use rustc::hir;
  39 use rustc::hir::def_id::DefId;
  40 use rustc::hir::def_id::LocalDefId;
  41 use rustc::hir::intravisit::{self, NestedVisitorMap, Visitor};
  42 use rustc::infer::UpvarRegion;
  43 use rustc::ty::{self, Ty, TyCtxt, UpvarSubsts};
  44 use syntax::ast;
  45 use syntax_pos::Span;
  46
  47 impl<'a, 'gcx, 'tcx> FnCtxt<'a, 'gcx, 'tcx> {
  48     pub fn closure_analyze(&self, body: &'gcx hir::Body) {
  49         InferBorrowKindVisitor { fcx: self }.visit_body(body);
  50
  51         // it's our job to process these.
  52         assert!(self.deferred_call_resolutions.borrow().is_empty());
  53     }
  54 }
  55
  56 struct InferBorrowKindVisitor<'a, 'gcx: 'a + 'tcx, 'tcx: 'a> {
  57     fcx: &'a FnCtxt<'a, 'gcx, 'tcx>,
  58 }
  59
  60 impl<'a, 'gcx, 'tcx> Visitor<'gcx> for InferBorrowKindVisitor<'a, 'gcx, 'tcx> {
  61     fn nested_visit_map<'this>(&'this mut self) -> NestedVisitorMap<'this, 'gcx> {
  62         NestedVisitorMap::None
  63     }
  64
  65     fn visit_expr(&mut self, expr: &'gcx hir::Expr) {
  66         if let hir::ExprKind::Closure(cc, _, body_id, _, _) = expr.node {
  67             let body = self.fcx.tcx.hir().body(body_id);
  68             self.visit_body(body);
  69             self.fcx
  70                 .analyze_closure(expr.hir_id, expr.span, body, cc);
  71         }
  72
  73         intravisit::walk_expr(self, expr);
  74     }
  75 }
  76
  77 impl<'a, 'gcx, 'tcx> FnCtxt<'a, 'gcx, 'tcx> {
  78     fn analyze_closure(
  79         &self,
  80         closure_hir_id: hir::HirId,
  81         span: Span,
  82         body: &hir::Body,
  83         capture_clause: hir::CaptureClause,
  84     ) {
  85         /*!
  86          * Analysis starting point.
  87          */
  88
  89         debug!(
  90             "analyze_closure(id={:?}, body.id={:?})",
  91             closure_hir_id,
  92             body.id()
  93         );
  94
  95         // Extract the type of the closure.
  96         let ty = self.node_ty(closure_hir_id);
  97         let (closure_def_id, substs) = match ty.sty {
  98             ty::Closure(def_id, substs) => (def_id, UpvarSubsts::Closure(substs)),
  99             ty::Generator(def_id, substs, _) => (def_id, UpvarSubsts::Generator(substs)),
 100             ty::Error => {
 101                 // #51714: skip analysis when we have already encountered type errors
 102                 return;
 103             }
 104             _ => {
 105                 span_bug!(
 106                     span,
 107                     "type of closure expr {:?} is not a closure {:?}",
 108                     closure_hir_id,
 109                     ty
 110                 );
 111             }
 112         };
 113
 114         let infer_kind = if let UpvarSubsts::Closure(closure_substs) = substs {
 115             if self.closure_kind(closure_def_id, closure_substs).is_none() {
 116                 Some(closure_substs)
 117             } else {
 118                 None
 119             }
 120         } else {
 121             None
 122         };
 123
 124         if let Some(upvars) = self.tcx.upvars(closure_def_id) {
 125             let mut upvar_list: Vec<ty::UpvarId> = Vec::with_capacity(upvars.len());
 126             for upvar in upvars.iter() {
 127                 let upvar_id = ty::UpvarId {
 128                     var_path: ty::UpvarPath {
 129                         hir_id: upvar.var_id(),
 130                     },
 131                     closure_expr_id: LocalDefId::from_def_id(closure_def_id),
 132                 };
 133                 debug!("seed upvar_id {:?}", upvar_id);
 134                 // Adding the upvar Id to the list of Upvars, which will be added
 135                 // to the map for the closure at the end of the for loop.
 136                 upvar_list.push(upvar_id);
 137
 138                 let capture_kind = match capture_clause {
 139                     hir::CaptureByValue => ty::UpvarCapture::ByValue,
 140                     hir::CaptureByRef => {
 141                         let origin = UpvarRegion(upvar_id, span);
 142                         let upvar_region = self.next_region_var(origin);
 143                         let upvar_borrow = ty::UpvarBorrow {
 144                             kind: ty::ImmBorrow,
 145                             region: upvar_region,
 146                         };
 147                         ty::UpvarCapture::ByRef(upvar_borrow)
 148                     }
 149                 };
 150
 151                 self.tables
 152                     .borrow_mut()
 153                     .upvar_capture_map
 154                     .insert(upvar_id, capture_kind);
 155             }
 156             // Add the vector of upvars to the map keyed with the closure id.
 157             // This gives us an easier access to them without having to call
 158             // tcx.upvars again..
 159             if !upvar_list.is_empty() {
 160                 self.tables
 161                     .borrow_mut()
 162                     .upvar_list
 163                     .insert(closure_def_id, upvar_list);
 164             }
 165         }
 166
 167         let body_owner_def_id = self.tcx.hir().body_owner_def_id(body.id());
 168         let region_scope_tree = &self.tcx.region_scope_tree(body_owner_def_id);
 169         let mut delegate = InferBorrowKind {
 170             fcx: self,
 171             closure_def_id: closure_def_id,
 172             current_closure_kind: ty::ClosureKind::LATTICE_BOTTOM,
 173             current_origin: None,
 174             adjust_upvar_captures: ty::UpvarCaptureMap::default(),
 175         };
 176         euv::ExprUseVisitor::with_infer(
 177             &mut delegate,
 178             &self.infcx,
 179             self.param_env,
 180             region_scope_tree,
 181             &self.tables.borrow(),
 182         )
 183         .consume_body(body);
 184
 185         if let Some(closure_substs) = infer_kind {
 186             // Unify the (as yet unbound) type variable in the closure
 187             // substs with the kind we inferred.
 188             let inferred_kind = delegate.current_closure_kind;
 189             let closure_kind_ty = closure_substs.closure_kind_ty(closure_def_id, self.tcx);
 190             self.demand_eqtype(span, inferred_kind.to_ty(self.tcx), closure_kind_ty);
 191
 192             // If we have an origin, store it.
 193             if let Some(origin) = delegate.current_origin {
 194                 self.tables
 195                     .borrow_mut()
 196                     .closure_kind_origins_mut()
 197                     .insert(closure_hir_id, origin);
 198             }
 199         }
 200
 201         self.tables
 202             .borrow_mut()
 203             .upvar_capture_map
 204             .extend(delegate.adjust_upvar_captures);
 205
 206         // Now that we've analyzed the closure, we know how each
 207         // variable is borrowed, and we know what traits the closure
 208         // implements (Fn vs FnMut etc). We now have some updates to do
 209         // with that information.
 210         //
 211         // Note that no closure type C may have an upvar of type C
 212         // (though it may reference itself via a trait object). This
 213         // results from the desugaring of closures to a struct like
 214         // `Foo<..., UV0...UVn>`. If one of those upvars referenced
 215         // C, then the type would have infinite size (and the
 216         // inference algorithm will reject it).
 217
 218         // Equate the type variables for the upvars with the actual types.
 219         let final_upvar_tys = self.final_upvar_tys(closure_hir_id);
 220         debug!(
 221             "analyze_closure: id={:?} substs={:?} final_upvar_tys={:?}",
 222             closure_hir_id, substs, final_upvar_tys
 223         );
 224         for (upvar_ty, final_upvar_ty) in substs
 225             .upvar_tys(closure_def_id, self.tcx)
 226             .zip(final_upvar_tys)
 227         {
 228             self.demand_suptype(span, upvar_ty, final_upvar_ty);
 229         }
 230
 231         // If we are also inferred the closure kind here,
 232         // process any deferred resolutions.
 233         let deferred_call_resolutions = self.remove_deferred_call_resolutions(closure_def_id);
 234         for deferred_call_resolution in deferred_call_resolutions {
 235             deferred_call_resolution.resolve(self);
 236         }
 237     }
 238
 239     // Returns a list of `ClosureUpvar`s for each upvar.
 240     fn final_upvar_tys(&self, closure_id: hir::HirId) -> Vec<Ty<'tcx>> {
 241         // Presently an unboxed closure type cannot "escape" out of a
 242         // function, so we will only encounter ones that originated in the
 243         // local crate or were inlined into it along with some function.
 244         // This may change if abstract return types of some sort are
 245         // implemented.
 246         let tcx = self.tcx;
 247         let closure_def_id = tcx.hir().local_def_id_from_hir_id(closure_id);
 248
 249         tcx.upvars(closure_def_id).iter().flat_map(|upvars| {
 250             upvars
 251                 .iter()
 252                 .map(|upvar| {
 253                     let var_hir_id = upvar.var_id();
 254                     let upvar_ty = self.node_ty(var_hir_id);
 255                     let upvar_id = ty::UpvarId {
 256                         var_path: ty::UpvarPath { hir_id: var_hir_id },
 257                         closure_expr_id: LocalDefId::from_def_id(closure_def_id),
 258                     };
 259                     let capture = self.tables.borrow().upvar_capture(upvar_id);
 260
 261                     debug!(
 262                         "var_id={:?} upvar_ty={:?} capture={:?}",
 263                         var_hir_id, upvar_ty, capture
 264                     );
 265
 266                     match capture {
 267                         ty::UpvarCapture::ByValue => upvar_ty,
 268                         ty::UpvarCapture::ByRef(borrow) => tcx.mk_ref(
 269                             borrow.region,
 270                             ty::TypeAndMut {
 271                                 ty: upvar_ty,
 272                                 mutbl: borrow.kind.to_mutbl_lossy(),
 273                             },
 274                         ),
 275                     }
 276                 })
 277         })
 278             .collect()
 279     }
 280 }
 281
 282 struct InferBorrowKind<'a, 'gcx: 'a + 'tcx, 'tcx: 'a> {
 283     fcx: &'a FnCtxt<'a, 'gcx, 'tcx>,
 284
 285     // The def-id of the closure whose kind and upvar accesses are being inferred.
 286     closure_def_id: DefId,
 287
 288     // The kind that we have inferred that the current closure
 289     // requires. Note that we *always* infer a minimal kind, even if
 290     // we don't always *use* that in the final result (i.e., sometimes
 291     // we've taken the closure kind from the expectations instead, and
 292     // for generators we don't even implement the closure traits
 293     // really).
 294     current_closure_kind: ty::ClosureKind,
 295
 296     // If we modified `current_closure_kind`, this field contains a `Some()` with the
 297     // variable access that caused us to do so.
 298     current_origin: Option<(Span, ast::Name)>,
 299
 300     // For each upvar that we access, we track the minimal kind of
 301     // access we need (ref, ref mut, move, etc).
 302     adjust_upvar_captures: ty::UpvarCaptureMap<'tcx>,
 303 }
 304
 305 impl<'a, 'gcx, 'tcx> InferBorrowKind<'a, 'gcx, 'tcx> {
 306     fn adjust_upvar_borrow_kind_for_consume(
 307         &mut self,
 308         cmt: &mc::cmt_<'tcx>,
 309         mode: euv::ConsumeMode,
 310     ) {
 311         debug!(
 312             "adjust_upvar_borrow_kind_for_consume(cmt={:?}, mode={:?})",
 313             cmt, mode
 314         );
 315
 316         // we only care about moves
 317         match mode {
 318             euv::Copy => {
 319                 return;
 320             }
 321             euv::Move(_) => {}
 322         }
 323
 324         let tcx = self.fcx.tcx;
 325
 326         // watch out for a move of the deref of a borrowed pointer;
 327         // for that to be legal, the upvar would have to be borrowed
 328         // by value instead
 329         let guarantor = cmt.guarantor();
 330         debug!(
 331             "adjust_upvar_borrow_kind_for_consume: guarantor={:?}",
 332             guarantor
 333         );
 334         debug!(
 335             "adjust_upvar_borrow_kind_for_consume: guarantor.cat={:?}",
 336             guarantor.cat
 337         );
 338         if let Categorization::Deref(_, mc::BorrowedPtr(..)) = guarantor.cat {
 339             debug!(
 340                 "adjust_upvar_borrow_kind_for_consume: found deref with note {:?}",
 341                 cmt.note
 342             );
 343             match guarantor.note {
 344                 mc::NoteUpvarRef(upvar_id) => {
 345                     debug!(
 346                         "adjust_upvar_borrow_kind_for_consume: \
 347                          setting upvar_id={:?} to by value",
 348                         upvar_id
 349                     );
 350
 351                     // to move out of an upvar, this must be a FnOnce closure
 352                     self.adjust_closure_kind(
 353                         upvar_id.closure_expr_id,
 354                         ty::ClosureKind::FnOnce,
 355                         guarantor.span,
 356                         var_name(tcx, upvar_id.var_path.hir_id),
 357                     );
 358
 359                     self.adjust_upvar_captures
 360                         .insert(upvar_id, ty::UpvarCapture::ByValue);
 361                 }
 362                 mc::NoteClosureEnv(upvar_id) => {
 363                     // we get just a closureenv ref if this is a
 364                     // `move` closure, or if the upvar has already
 365                     // been inferred to by-value. In any case, we
 366                     // must still adjust the kind of the closure
 367                     // to be a FnOnce closure to permit moves out
 368                     // of the environment.
 369                     self.adjust_closure_kind(
 370                         upvar_id.closure_expr_id,
 371                         ty::ClosureKind::FnOnce,
 372                         guarantor.span,
 373                         var_name(tcx, upvar_id.var_path.hir_id),
 374                     );
 375                 }
 376                 mc::NoteIndex | mc::NoteNone => {}
 377             }
 378         }
 379     }
 380
 381     /// Indicates that `cmt` is being directly mutated (e.g., assigned
 382     /// to). If cmt contains any by-ref upvars, this implies that
 383     /// those upvars must be borrowed using an `&mut` borrow.
 384     fn adjust_upvar_borrow_kind_for_mut(&mut self, cmt: &mc::cmt_<'tcx>) {
 385         debug!("adjust_upvar_borrow_kind_for_mut(cmt={:?})", cmt);
 386
 387         match cmt.cat.clone() {
 388             Categorization::Deref(base, mc::Unique)
 389             | Categorization::Interior(base, _)
 390             | Categorization::Downcast(base, _) => {
 391                 // Interior or owned data is mutable if base is
 392                 // mutable, so iterate to the base.
 393                 self.adjust_upvar_borrow_kind_for_mut(&base);
 394             }
 395
 396             Categorization::Deref(base, mc::BorrowedPtr(..)) => {
 397                 if !self.try_adjust_upvar_deref(cmt, ty::MutBorrow) {
 398                     // assignment to deref of an `&mut`
 399                     // borrowed pointer implies that the
 400                     // pointer itself must be unique, but not
 401                     // necessarily *mutable*
 402                     self.adjust_upvar_borrow_kind_for_unique(&base);
 403                 }
 404             }
 405
 406             Categorization::Deref(_, mc::UnsafePtr(..))
 407             | Categorization::StaticItem
 408             | Categorization::ThreadLocal(..)
 409             | Categorization::Rvalue(..)
 410             | Categorization::Local(_)
 411             | Categorization::Upvar(..) => {
 412                 return;
 413             }
 414         }
 415     }
 416
 417     fn adjust_upvar_borrow_kind_for_unique(&mut self, cmt: &mc::cmt_<'tcx>) {
 418         debug!("adjust_upvar_borrow_kind_for_unique(cmt={:?})", cmt);
 419
 420         match cmt.cat.clone() {
 421             Categorization::Deref(base, mc::Unique)
 422             | Categorization::Interior(base, _)
 423             | Categorization::Downcast(base, _) => {
 424                 // Interior or owned data is unique if base is
 425                 // unique.
 426                 self.adjust_upvar_borrow_kind_for_unique(&base);
 427             }
 428
 429             Categorization::Deref(base, mc::BorrowedPtr(..)) => {
 430                 if !self.try_adjust_upvar_deref(cmt, ty::UniqueImmBorrow) {
 431                     // for a borrowed pointer to be unique, its
 432                     // base must be unique
 433                     self.adjust_upvar_borrow_kind_for_unique(&base);
 434                 }
 435             }
 436
 437             Categorization::Deref(_, mc::UnsafePtr(..))
 438             | Categorization::StaticItem
 439             | Categorization::ThreadLocal(..)
 440             | Categorization::Rvalue(..)
 441             | Categorization::Local(_)
 442             | Categorization::Upvar(..) => {}
 443         }
 444     }
 445
 446     fn try_adjust_upvar_deref(
 447         &mut self,
 448         cmt: &mc::cmt_<'tcx>,
 449         borrow_kind: ty::BorrowKind,
 450     ) -> bool {
 451         assert!(match borrow_kind {
 452             ty::MutBorrow => true,
 453             ty::UniqueImmBorrow => true,
 454
 455             // imm borrows never require adjusting any kinds, so we don't wind up here
 456             ty::ImmBorrow => false,
 457         });
 458
 459         let tcx = self.fcx.tcx;
 460
 461         match cmt.note {
 462             mc::NoteUpvarRef(upvar_id) => {
 463                 // if this is an implicit deref of an
 464                 // upvar, then we need to modify the
 465                 // borrow_kind of the upvar to make sure it
 466                 // is inferred to mutable if necessary
 467                 self.adjust_upvar_borrow_kind(upvar_id, borrow_kind);
 468
 469                 // also need to be in an FnMut closure since this is not an ImmBorrow
 470                 self.adjust_closure_kind(
 471                     upvar_id.closure_expr_id,
 472                     ty::ClosureKind::FnMut,
 473                     cmt.span,
 474                     var_name(tcx, upvar_id.var_path.hir_id),
 475                 );
 476
 477                 true
 478             }
 479             mc::NoteClosureEnv(upvar_id) => {
 480                 // this kind of deref occurs in a `move` closure, or
 481                 // for a by-value upvar; in either case, to mutate an
 482                 // upvar, we need to be an FnMut closure
 483                 self.adjust_closure_kind(
 484                     upvar_id.closure_expr_id,
 485                     ty::ClosureKind::FnMut,
 486                     cmt.span,
 487                     var_name(tcx, upvar_id.var_path.hir_id),
 488                 );
 489
 490                 true
 491             }
 492             mc::NoteIndex | mc::NoteNone => false,
 493         }
 494     }
 495
 496     /// We infer the borrow_kind with which to borrow upvars in a stack closure.
 497     /// The borrow_kind basically follows a lattice of `imm < unique-imm < mut`,
 498     /// moving from left to right as needed (but never right to left).
 499     /// Here the argument `mutbl` is the borrow_kind that is required by
 500     /// some particular use.
 501     fn adjust_upvar_borrow_kind(&mut self, upvar_id: ty::UpvarId, kind: ty::BorrowKind) {
 502         let upvar_capture = self
 503             .adjust_upvar_captures
 504             .get(&upvar_id)
 505             .cloned()
 506             .unwrap_or_else(|| self.fcx.tables.borrow().upvar_capture(upvar_id));
 507         debug!(
 508             "adjust_upvar_borrow_kind(upvar_id={:?}, upvar_capture={:?}, kind={:?})",
 509             upvar_id, upvar_capture, kind
 510         );
 511
 512         match upvar_capture {
 513             ty::UpvarCapture::ByValue => {
 514                 // Upvar is already by-value, the strongest criteria.
 515             }
 516             ty::UpvarCapture::ByRef(mut upvar_borrow) => {
 517                 match (upvar_borrow.kind, kind) {
 518                     // Take RHS:
 519                     (ty::ImmBorrow, ty::UniqueImmBorrow)
 520                     | (ty::ImmBorrow, ty::MutBorrow)
 521                     | (ty::UniqueImmBorrow, ty::MutBorrow) => {
 522                         upvar_borrow.kind = kind;
 523                         self.adjust_upvar_captures
 524                             .insert(upvar_id, ty::UpvarCapture::ByRef(upvar_borrow));
 525                     }
 526                     // Take LHS:
 527                     (ty::ImmBorrow, ty::ImmBorrow)
 528                     | (ty::UniqueImmBorrow, ty::ImmBorrow)
 529                     | (ty::UniqueImmBorrow, ty::UniqueImmBorrow)
 530                     | (ty::MutBorrow, _) => {}
 531                 }
 532             }
 533         }
 534     }
 535
 536     fn adjust_closure_kind(
 537         &mut self,
 538         closure_id: LocalDefId,
 539         new_kind: ty::ClosureKind,
 540         upvar_span: Span,
 541         var_name: ast::Name,
 542     ) {
 543         debug!(
 544             "adjust_closure_kind(closure_id={:?}, new_kind={:?}, upvar_span={:?}, var_name={})",
 545             closure_id, new_kind, upvar_span, var_name
 546         );
 547
 548         // Is this the closure whose kind is currently being inferred?
 549         if closure_id.to_def_id() != self.closure_def_id {
 550             debug!("adjust_closure_kind: not current closure");
 551             return;
 552         }
 553
 554         // closures start out as `Fn`.
 555         let existing_kind = self.current_closure_kind;
 556
 557         debug!(
 558             "adjust_closure_kind: closure_id={:?}, existing_kind={:?}, new_kind={:?}",
 559             closure_id, existing_kind, new_kind
 560         );
 561
 562         match (existing_kind, new_kind) {
 563             (ty::ClosureKind::Fn, ty::ClosureKind::Fn)
 564             | (ty::ClosureKind::FnMut, ty::ClosureKind::Fn)
 565             | (ty::ClosureKind::FnMut, ty::ClosureKind::FnMut)
 566             | (ty::ClosureKind::FnOnce, _) => {
 567                 // no change needed
 568             }
 569
 570             (ty::ClosureKind::Fn, ty::ClosureKind::FnMut)
 571             | (ty::ClosureKind::Fn, ty::ClosureKind::FnOnce)
 572             | (ty::ClosureKind::FnMut, ty::ClosureKind::FnOnce) => {
 573                 // new kind is stronger than the old kind
 574                 self.current_closure_kind = new_kind;
 575                 self.current_origin = Some((upvar_span, var_name));
 576             }
 577         }
 578     }
 579 }
 580
 581 impl<'a, 'gcx, 'tcx> euv::Delegate<'tcx> for InferBorrowKind<'a, 'gcx, 'tcx> {
 582     fn consume(
 583         &mut self,
 584         _consume_id: hir::HirId,
 585         _consume_span: Span,
 586         cmt: &mc::cmt_<'tcx>,
 587         mode: euv::ConsumeMode,
 588     ) {
 589         debug!("consume(cmt={:?},mode={:?})", cmt, mode);
 590         self.adjust_upvar_borrow_kind_for_consume(cmt, mode);
 591     }
 592
 593     fn matched_pat(
 594         &mut self,
 595         _matched_pat: &hir::Pat,
 596         _cmt: &mc::cmt_<'tcx>,
 597         _mode: euv::MatchMode,
 598     ) {
 599     }
 600
 601     fn consume_pat(
 602         &mut self,
 603         _consume_pat: &hir::Pat,
 604         cmt: &mc::cmt_<'tcx>,
 605         mode: euv::ConsumeMode,
 606     ) {
 607         debug!("consume_pat(cmt={:?},mode={:?})", cmt, mode);
 608         self.adjust_upvar_borrow_kind_for_consume(cmt, mode);
 609     }
 610
 611     fn borrow(
 612         &mut self,
 613         borrow_id: hir::HirId,
 614         _borrow_span: Span,
 615         cmt: &mc::cmt_<'tcx>,
 616         _loan_region: ty::Region<'tcx>,
 617         bk: ty::BorrowKind,
 618         _loan_cause: euv::LoanCause,
 619     ) {
 620         debug!(
 621             "borrow(borrow_id={}, cmt={:?}, bk={:?})",
 622             borrow_id, cmt, bk
 623         );
 624
 625         match bk {
 626             ty::ImmBorrow => {}
 627             ty::UniqueImmBorrow => {
 628                 self.adjust_upvar_borrow_kind_for_unique(cmt);
 629             }
 630             ty::MutBorrow => {
 631                 self.adjust_upvar_borrow_kind_for_mut(cmt);
 632             }
 633         }
 634     }
 635
 636     fn decl_without_init(&mut self, _id: hir::HirId, _span: Span) {}
 637
 638     fn mutate(
 639         &mut self,
 640         _assignment_id: hir::HirId,
 641         _assignment_span: Span,
 642         assignee_cmt: &mc::cmt_<'tcx>,
 643         _mode: euv::MutateMode,
 644     ) {
 645         debug!("mutate(assignee_cmt={:?})", assignee_cmt);
 646
 647         self.adjust_upvar_borrow_kind_for_mut(assignee_cmt);
 648     }
 649 }
 650
 651 fn var_name(tcx: TyCtxt<'_, '_, '_>, var_hir_id: hir::HirId) -> ast::Name {
 652     tcx.hir().name_by_hir_id(var_hir_id)
 653 }